{"type":"doc","content":[{"type":"paragraph","content":[{"text":" In the global section you can define settings that relate to all the libraries that are currently loaded.","type":"text"}]},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"style":{"value":"circle"}},"macroMetadata":{"macroId":{"value":"a13a7702-a2c5-48e9-a7d8-4f920cb627f3"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"84c168b2-66d8-4939-8994-6fe65af2ee97"}},{"type":"heading","attrs":{"level":1},"content":[{"text":"Global Setup","type":"text"}]},{"type":"paragraph","content":[{"text":"Here your can define which ","type":"text"},{"text":"setup file","type":"text","marks":[{"type":"link","attrs":{"href":"/wiki/spaces/DOCU/pages/100433999#Setup-file"}}]},{"text":" should be used. This controls which Global Config to load and edit. ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Create new configuration","type":"text"}]},{"type":"paragraph","content":[{"text":"To create a new config click the “Create new config” button on the right side of “Path of config file“.","type":"text"},{"type":"hardBreak"},{"text":"This will show the startup dialog.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":224,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":224,"alt":"image-20240607-163002.png","id":"d0db7d4e-9cb6-4038-9845-7fef69a5aa21","collection":"contentId-137593095","type":"file","height":95}}]},{"type":"mediaSingle","attrs":{"layout":"center","width":760,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":1366,"alt":"image-20240624-141144.png","id":"a2df03d5-489f-479f-b682-e6f17e7d80b3","collection":"contentId-137593095","type":"file","height":757}},{"type":"caption","content":[{"text":"Welcome screen to create a new configuration","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Recent configurations","type":"text"}]},{"type":"paragraph","content":[{"text":"The ","type":"text"},{"text":"Recent config file","type":"text","marks":[{"type":"strong"}]},{"text":" is a history of the most recent configs. It shows up to 10 of the last recent config file paths. This is a quick way to switch between different library setups.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":224,"widthType":"pixel"},"content":[{"type":"media","attrs":{"width":224,"alt":"image-20240607-163107.png","id":"648dde97-4d20-4e25-b60e-4bf908812f61","collection":"contentId-137593095","type":"file","height":95}}]},{"type":"heading","attrs":{"level":1},"content":[{"text":"Setup configuration","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Default values","type":"text"}]},{"type":"paragraph","content":[{"text":"First let’s have at look what ","type":"text"},{"text":"default config value","type":"text","marks":[{"type":"em"}]},{"text":" you can set:","type":"text"}]},{"type":"table","attrs":{"layout":"full-width","width":1800.0,"localId":"d40f2e92-a3c8-405b-bcb1-1dd619679453"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[348.0]},"content":[{"type":"paragraph","content":[{"text":"label","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.0]},"content":[{"type":"paragraph","content":[{"text":"key","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[1084.0]},"content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[348.0]},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Element-Number Padding","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.0]},"content":[{"type":"paragraph","content":[{"text":"element_number_padding","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1084.0]},"content":[{"type":"paragraph","content":[{"text":"Set the number padding for the naming convention.","type":"text"},{"type":"hardBreak"},{"text":"Value of 5 looks like this: ","type":"text"},{"text":"fire_00023","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"default: ","type":"text"},{"text":"5","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[348.0]},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Frame Padding","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.0]},"content":[{"type":"paragraph","content":[{"text":"frame_padding","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1084.0]},"content":[{"type":"paragraph","content":[{"text":"Set the frame padding for a file sequence","type":"text"},{"type":"hardBreak"},{"text":"Value of 4 looks like this: ","type":"text"},{"text":"filename.0001.exr","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"default: ","type":"text"},{"text":"4","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[348.0]},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Filmstrip Number of Frames","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.0]},"content":[{"type":"paragraph","content":[{"text":"filmstrip_length","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1084.0]},"content":[{"type":"paragraph","content":[{"text":"Set the frames used for the preview filmstrip in the ingest view. No matter the length of the sequence, the filmstrip length will be this many frames.","type":"text"},{"type":"hardBreak"},{"text":"default: ","type":"text"},{"text":"24","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[348.0]},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Thumbnail Frame of Sequence","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.0]},"content":[{"type":"paragraph","content":[{"text":"thumbnail_frame","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1084.0]},"content":[{"type":"paragraph","content":[{"text":"Set which frame of a sequence should be used for the thumbnail frame.","type":"text"},{"type":"hardBreak"},{"text":"When the value is ","type":"text"},{"text":"meaningful","type":"text","marks":[{"type":"code"}]},{"text":" the software tried to detect some representative frame for an sequence","type":"text"},{"type":"hardBreak"},{"text":"default: ","type":"text"},{"text":"meaningful","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[348.0]},"content":[{"type":"heading","attrs":{"level":4},"content":[{"text":"Re-number Frames of Sequence","type":"text"},{"type":"hardBreak"},{"text":"First Frame of Sequence","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[368.0]},"content":[{"type":"paragraph","content":[{"text":"first_frame","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[1084.0]},"content":[{"type":"paragraph","content":[{"text":"If disabled, no renaming will be happening for file sequences.","type":"text"},{"type":"hardBreak"},{"text":"If enabled, it sets the first frame of a sequence when transcoding a file sequence. The files of the sequence will be renamed.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"default: ","type":"text"},{"text":"enable = true","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"first frame = 1001","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Some VFX studios like start with the common 1001 frame. Other studios start with 0 or 1.","type":"text"},{"type":"hardBreak"},{"text":"This forces the artist to align the correct range before working on a shot. It makes sure that the frame range of an element is long enough.","type":"text"}]}]}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Color Code","type":"text"}]},{"type":"paragraph","content":[{"text":"The Color Code is a visual help to distinguish between the path items. Each color represents a different type of the items that you can drag'n'drop around to build the folder structure and naming convention. Some values are predefined, some are only known during the ingest phase and others can be set manually by you.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"File path definitions","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":800,"alt":"das element vfx asset element library software settings main path","id":"edaa4948-4909-4d6f-b92f-7f9c49ff6bbd","collection":"contentId-137593095","type":"file","height":357}}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"This is the part where you define your naming convention and file path structure","type":"text"}]}]},{"type":"paragraph","content":[{"text":"This is where you set the naming convention and file structure on disk.","type":"text"},{"type":"hardBreak"},{"text":"You need to define the ","type":"text"},{"text":"file path patterns","type":"text","marks":[{"type":"em"}]},{"text":" so the software knows where to store the elements file data. These two path patterns are the most important path patterns that the transcoding template will use.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Types of path patterns","type":"text"}]},{"type":"paragraph","content":[{"text":"Which path patterns will be used depends on the output format and the transcoding templates setting for each library. There are two types of path patterns.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In transcoding template you can set this with the option: ","type":"text"},{"text":"Type of output file","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Single files","type":"text"}]},{"type":"paragraph","content":[{"text":"Single files are something like a movie file or single textures files. Files without frame count.","type":"text"}]},{"type":"codeBlock","content":[{"text":"/some/path/to/element.mov\n/some/path/to/element.exr\n/some/path/to/element_v01.exr","type":"text"}]},{"type":"paragraph","content":[{"text":"Example when the single file pattern is used:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Copy of a single file like a movie file","type":"text"},{"type":"hardBreak"},{"text":"my-movie-file.mov -> fire_000023.mov","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Sequence files","type":"text"}]},{"type":"paragraph","content":[{"text":"Renderings or sequences with frame counter.","type":"text"}]},{"type":"codeBlock","content":[{"text":"/some/path/to/element.1001.exr\n/some/path/to/element_1001.exr","type":"text"}]},{"type":"paragraph","content":[{"text":"Example when the sequence file pattern is used:","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"For a movie file (source is a single file) that will be transcoded to a frame sequence with frame counter.","type":"text"},{"text":"my-movie-file.mov > fire_000023.1001.exr","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Use '#' for the frame counter. The default frame count padding is 4.","type":"text","marks":[{"type":"em"}]},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Path Patterns","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":800,"id":"65de0aa7-e0ff-492f-8b96-7fc883277b75","collection":"contentId-137593095","type":"file","height":506}}]},{"type":"paragraph","content":[{"text":"You can create a so called path pattern. A pattern is assembled by placeholder values. These values get resolved into the actual value on ingest/render time.","type":"text"}]},{"type":"paragraph","content":[{"text":"The reason is that we don’t know some values at this time because they are dependent on the element that you want to ingest. For example, the width and height is depending on the source item.","type":"text"}]},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"By using the combination of ","type":"text"},{"text":"path patterns,","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"predefined path values","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"custom path values","type":"text","marks":[{"type":"em"}]},{"text":", ","type":"text"},{"type":"hardBreak"},{"text":"you should be able to build any naming convention and file structure you like.","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Path patterns can be assembled out of any number of other path patterns. They will get resolved as much as they can. Finally, all values (predefined & custom) will get resolved into actual values.","type":"text"}]}]},{"type":"paragraph"},{"type":"rule"},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"This might look a little bit weird at the beginning, but this system gives you full control over how to assemble your naming convention. You will see the benefit of it in a second.","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: resolution","type":"text"}]},{"type":"paragraph","content":[{"text":"Our source image is an image of a flame with the resolution of width 1920 and height 1080.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"We create a path pattern to define the naming convention of the resolution folder as followed:","type":"text"}]},{"type":"paragraph","content":[{"text":"resolution_pattern : ","type":"text","marks":[{"type":"strong"}]},{"text":"x","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"If we now ingest the element, the pattern gets resolved to: ","type":"text"},{"text":"1920x1080","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":" is a tag. Pattern Tags are defined by the < (less than) and > (greater than) characters.","type":"text"},{"type":"hardBreak"},{"text":"Everything that is not surrounded by <> are manually set characters and will not get resolved.","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Now let’s take it a step further.","type":"text"}]},{"type":"paragraph","content":[{"text":"We can define ","type":"text"},{"text":"custom path values","type":"text","marks":[{"type":"em"}]},{"text":" in the ","type":"text"},{"text":"path values","type":"text","marks":[{"type":"em"}]},{"text":" section.","type":"text"},{"type":"hardBreak"},{"text":"These values get included in the values that can get resolved by the resolver.","type":"text"}]},{"type":"paragraph","content":[{"text":"Lets create a path value:","type":"text"},{"type":"hardBreak"},{"text":"colorspace :","type":"text","marks":[{"type":"strong"}]},{"text":" ","type":"text"},{"text":"linear","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"and update the pattern from before:","type":"text"},{"type":"hardBreak"},{"text":"resolution_pattern : ","type":"text","marks":[{"type":"strong"}]},{"text":"abc_x_","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"This gets resolved to: ","type":"text"},{"text":"abc_1920x1080_linear","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"Notice the tag we added at the end? ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" is a custom pattern tag.","type":"text"},{"type":"hardBreak"},{"text":"The resolver will look at the ","type":"text"},{"text":"path value","type":"text","marks":[{"type":"em"}]},{"text":" ","type":"text"},{"text":"colorspace","type":"text","marks":[{"type":"strong"}]},{"text":" and use its value ","type":"text"},{"text":"linear","type":"text","marks":[{"type":"code"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"In the settings section: library → transcoding templates","type":"text"},{"type":"hardBreak"},{"text":"you can overwrite the ","type":"text"},{"text":"path patterns","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"path values","type":"text","marks":[{"type":"em"}]},{"text":".","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"If we create a ","type":"text"},{"text":"library transcoding template","type":"text","marks":[{"type":"em"}]},{"text":" that creates a thumbnail preview for our elements, we can overwrite the path value ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" by another value. For example: ","type":"text"},{"text":"srgb","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"The path pattern for this transcoding template gets now resolved to: ","type":"text"},{"text":"abc_1920x1080_srgb","type":"text","marks":[{"type":"code"}]}]},{"type":"rule"},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: category","type":"text"}]},{"type":"paragraph","content":[{"text":"Let's create a path pattern for defining the naming convention for folder of the element.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"Create a new path pattern:","type":"text"},{"type":"hardBreak"},{"text":"element_name : ","type":"text","marks":[{"type":"strong"}]},{"text":"_","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"In the ingest view we decide that the category of the element is ","type":"text"},{"text":"flame","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The base (top parent) category of ","type":"text"},{"text":"flame","type":"text","marks":[{"type":"strong"}]},{"text":" is ","type":"text"},{"text":"fire","type":"text","marks":[{"type":"strong"}]},{"text":". Because a flame is a part of a fire.","type":"text"}]},{"type":"paragraph","content":[{"text":"This means that ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" resolves to ","type":"text"},{"text":"flame","type":"text","marks":[{"type":"code"}]},{"text":" and ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" resolves to ","type":"text"},{"text":"fire","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"What about ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":"?","type":"text"},{"type":"hardBreak"},{"text":"This is one of the ","type":"text"},{"text":"predefined values.","type":"text","marks":[{"type":"em"}]},{"text":" These predefined values are values that are only known once an element is ingested because the values are dependent on the elements data.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"If we now ingest a new fire element and there are already 230 fire elements in the database, the element number will increase by +1. Thus the ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":" will resolve to ","type":"text"},{"text":"231","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph","content":[{"text":"So finally: ","type":"text"},{"text":"_","type":"text","marks":[{"type":"code"}]},{"text":" resolves to ","type":"text"},{"text":"flame_231","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Why should we use the base category?","type":"text"}]},{"type":"paragraph","content":[{"text":"We want our library to be sustainable and be as static as possible for many years.","type":"text"},{"type":"hardBreak"},{"text":"Once we ingest an element it should not move or be renamed.","type":"text"},{"type":"hardBreak"},{"text":"If we want to open up a project file from years ago all the media files should be found.","type":"text"}]},{"type":"paragraph","content":[{"text":"That is why you should decided to store the elements in the base category folder","type":"text"}]}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"To go up one directory you can use the relative path double dots '..'","type":"text"},{"type":"hardBreak"},{"text":"/some/path//","type":"text"},{"text":"..","type":"text","marks":[{"type":"strong"}]},{"text":"/ -> will resolve to /some/path/the-proxy-folder","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Path Values","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":65.0},"content":[{"type":"media","attrs":{"width":800,"id":"00b0e971-cd81-40f9-808a-111b44586c5d","collection":"contentId-137593095","type":"file","height":702}}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"Path values are used to resolve the values of the ","type":"text"},{"text":"path patterns","type":"text","marks":[{"type":"em"}]},{"text":" depending on the element that will be ingested or rendered. Some values are known once we actually know the data that we want to ingest, others values can be set by you (custom values). The custom values can be overwritten in the library and the transcoding templates.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Predefined path values","type":"text"}]},{"type":"paragraph","content":[{"text":"The predefined values are used as placeholders in the path patterns. They are divided into separate predefined groups that will be commonly used. For each group you can access the sub-keys.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Predefined path values are given and can not be changed manually","type":"text"}]}]},{"type":"heading","attrs":{"level":4},"content":[{"type":"hardBreak"},{"text":"Reserved keywords","type":"text"}]},{"type":"paragraph","content":[{"text":"There are a few reserved keywords that will not be resolved. They are for example required by the renderfarm manager Deadline.","type":"text"},{"type":"hardBreak"},{"text":" ","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Example","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"If you want to get the ","type":"text"},{"text":"width","type":"text","marks":[{"type":"em"}]},{"text":" value of the source element you ingest, you access the group ","type":"text"},{"text":"resolution","type":"text","marks":[{"type":"code"}]},{"text":" and the sub-key ","type":"text"},{"text":"width","type":"text","marks":[{"type":"code"}]},{"text":" in the path pattern like this: ","type":"text"},{"text":"","type":"text","marks":[{"type":"code"}]},{"text":". This will resolve the source image width value for you.","type":"text"},{"type":"hardBreak"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Example: element","type":"text"}]},{"type":"paragraph","content":[{"text":"Path of element that we want to ingest:","type":"text"},{"type":"hardBreak"},{"text":"/some/path/to/file.%04.exr","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"It is a sequence of OpenEXR files that contain a picture of a flame.","type":"text"},{"type":"hardBreak"},{"text":"The first frame of the sequence is ","type":"text"},{"text":"1001","type":"text","marks":[{"type":"code"}]},{"text":" and last frame is ","type":"text"},{"text":"1042","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"Each image has a resolution of width ","type":"text"},{"text":"1920","type":"text","marks":[{"type":"code"}]},{"text":", a height of ","type":"text"},{"text":"1080","type":"text","marks":[{"type":"code"}]},{"text":" and a pixel aspect ration of ","type":"text"},{"text":"1","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"},{"type":"hardBreak"},{"text":"In the library there are already ","type":"text"},{"text":"22","type":"text","marks":[{"type":"code"}]},{"text":" fire elements.","type":"text"}]},{"type":"paragraph","content":[{"text":"In the ingest view we decide that the category of the element is ","type":"text"},{"text":"flame","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The base (top parent) category of ","type":"text"},{"text":"flame","type":"text","marks":[{"type":"code"}]},{"text":" is ","type":"text"},{"text":"fire","type":"text","marks":[{"type":"code"}]},{"text":". Because a ","type":"text"},{"text":"flame","type":"text","marks":[{"type":"code"}]},{"text":" is a part of a ","type":"text"},{"text":"fire","type":"text","marks":[{"type":"code"}]},{"text":".","type":"text"}]},{"type":"paragraph"},{"type":"paragraph","content":[{"text":"In this overview you can see how each of the predefined values would be resolved into the actual value:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"8f388e8e-1ec1-4b5f-af6e-ec66549fb880"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"description","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"predefined value","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"example resolves to","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"source image width","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"1920","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"source image height","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"1080","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"image pixel aspect resolution","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"1","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"source elements file extension","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"exr","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Frame counter for a sequence","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"#","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"output sequence first frame","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"1001","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"output sequence last frame","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"1042","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"number counter of this element","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"00023","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Globally unique element ID","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"f4ec01102a4440769be04d9004a717c8","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"readable name for flame category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"flame","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"unique ID for flame category","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Q235544","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"readable name of the base category for flame, based on the hierarchy category tree","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"fire","type":"text","marks":[{"type":"code"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"unique ID of the base category for flame, based on the hierarchy category tree","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"","type":"text","marks":[{"type":"code"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.67]},"content":[{"type":"paragraph","content":[{"text":"Q3196","type":"text","marks":[{"type":"code"}]}]}]}]}]},{"type":"paragraph"},{"type":"panel","attrs":{"panelType":"success"},"content":[{"type":"paragraph","content":[{"text":"The element UUID (Universally unique identifier) is globally unique across all libraries and databases. This allows you to track this one particular element for all “eternity” with this unique ID.","type":"text"},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"A hexadecimal presentation is used of the UUID that gets rid of the “-” dashes, which is better for using it in the filename.","type":"text"}]},{"type":"paragraph","content":[{"text":"Learn more about ","type":"text"},{"text":"Universally unique identifiers.","type":"text","marks":[{"type":"link","attrs":{"href":"https://en.wikipedia.org/wiki/Universally_unique_identifier"}}]}]}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":3},"content":[{"text":"Custom path values","type":"text"}]},{"type":"paragraph","content":[{"text":"These are the values that you can define. These custom path values get resolved in the path patterns.","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Custom path values are the values defined by the user","type":"text"}]}]},{"type":"paragraph","content":[{"type":"hardBreak"},{"text":"Examples","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"server","type":"text","marks":[{"type":"strong"}]},{"text":" : ","type":"text"},{"text":"/path/to/server","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"text":"library_name","type":"text","marks":[{"type":"strong"}]},{"text":": ","type":"text"},{"text":"my-element","type":"text","marks":[{"type":"code"}]},{"type":"hardBreak"},{"type":"hardBreak"},{"text":"If you use ","type":"text"},{"text":"path patterns","type":"text","marks":[{"type":"em"}]},{"text":" that reference ","type":"text"},{"text":"path values","type":"text","marks":[{"type":"em"}]},{"text":" you have to make sure that these values exist in the path values section. If something can not be resolved because values are not defined, the ingest or rendering of proxies will fail and you will see an error message.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Overwrite pattern & values","type":"text"}]},{"type":"paragraph","content":[{"text":"The server path or the folder where the library data is stored might chance for each library.","type":"text"},{"type":"hardBreak"},{"text":"Overwriting ","type":"text"},{"text":"path pattern","type":"text","marks":[{"type":"em"}]},{"text":" and ","type":"text"},{"text":"path values","type":"text","marks":[{"type":"em"}]},{"text":" is based on the concept that you only need to overwrite values for each library, which reduced the complexity and misalignment of the file structure.","type":"text"}]},{"type":"paragraph","content":[{"text":"This gives you the control to setup global conditions for all libraries and you only need to change one or two values for each library.","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Collection Database","type":"text"}]},{"type":"paragraph","content":[{"text":"Collections can be saved in a database or a file on disk. In this section database connections can be created. For more information please check out ","type":"text"},{"text":"this documentation here","type":"text","marks":[{"type":"link","attrs":{"href":"https://docu.das-element.com/docu/collections#Collections-DatabaseCollection"}}]}]},{"type":"paragraph"}],"version":1}