User Tools

Site Tools


en:orx:config:settings_structure:orxanim

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
en:orx:config:settings_structure:orxanim [2018/02/13 20:46 (6 years ago)] – ↷ Links adapted because of a move operation iarwainen:orx:config:settings_structure:orxanim [2023/09/19 23:35 (6 months ago)] (current) sausage
Line 7: Line 7:
 <code ini> <code ini>
 [AnimationSetTemplate] [AnimationSetTemplate]
- +Frequency     = <float
-Frequency   = <Float+KeepInCache   = <bool
-KeepInCache = <Bool+StartAnim     = Animation 
-StartAnim   = Animation +StartAnimList = Animation1 # ... # AnimationN 
-Prefix      = <String> string +Prefix        = <string> 
-Digits      = <Int+Digits        = <int
-Animation   [String] # [Int] +Animation     <string> 
-Animation   [String] # [String] +Animation     <string> 
-Animation-> = {.!+-}Animation1 # {.!+-}Animation2 # ...+Animation     = empty 
 +Animation->   = {.!+-}Animation1 # ... # {.!+-}AnimationN
  
 </code> </code>
Line 23: Line 24:
 <code ini> <code ini>
 [AnimationTemplate] [AnimationTemplate]
-Texture = path/to/ImageFile.ext +Texture       = path/to/ImageFile.ext 
-TextureOrigin = <Vector+TextureOrigin = <vector
-TextureSize = <Vector+TextureSize   = <vector> 
-Direction = left|right|down|up # left|right|down|up +Text          = TextTemplate  
-FrameSize = <Vector+Direction     = left | right | down | up # left | right | down | up 
-KeyDuration = <Float>+FrameSize     = <vector
 +KeyDuration   = <float>
  
 [AnimationTemplate<N>] ; eg: AnimationTemplate0003 [AnimationTemplate<N>] ; eg: AnimationTemplate0003
-KeyEvent = [String] # <Float+KeyEvent      = <string
-TextureOrigin = <Vector+TextureOrigin = <vector
-TextureSize = <Vector+TextureSize   = <vector> 
-KeyDuration = <Float>+FrameIndex    = <int> 
 +String        = "string to display" 
 +KeyDuration   = <float>
  
 </code> </code>
Line 52: Line 56:
   * ''Frequency'': Relative frequency to which the animations will be played. Defaults to 1.0, which means the animation will be played with the timing defined in the config.   * ''Frequency'': Relative frequency to which the animations will be played. Defaults to 1.0, which means the animation will be played with the timing defined in the config.
   * ''KeepInCache'': If true, the animation set will always stay in cache, even if not currently used by any objects. Can save time but costs memory. Defaults to false.   * ''KeepInCache'': If true, the animation set will always stay in cache, even if not currently used by any objects. Can save time but costs memory. Defaults to false.
-  * ''StartAnim'': Name of the entry point of the animation graph, first animation to be played by default. +  * ''StartAnim'': Entry point of the animation graph, first animation to be played by default. If this StartAnim is defined, StartAnimList will be ignored. 
-  * ''Prefix'': String prefix that will used in front of all animation names and frames. Defaults to empty string. +  * ''StartAnimList'': Multiple entry points for disjointed animation graphs. The first animation in the list will be played by default. Ignored if StartAnim is defined
-  * ''Digits'': How many digits will be used for the animation frame suffixes, ie: 0001. Defaults to 4+  * ''Prefix'': Prefix that will used in front of all animation names and frames, ie: 0001. Defaults to empty string. 
-  * <Animation Name>: [String] # [Int]; NB: The first value, optional String, defines a name for the animation config template to use, defaults to the key itself. The second value, optional Int, specifies how many frames should be created: greater than 0maximum frames to be loaded, -1as many frames as can fit inside the whole texture, 0as many frames as are defined in config, defaults to -1. +  * ''Digits'': How many digits will be used for the animation frame suffixes. Defaults to 0 (ie. as many digits as needed, without any prefixed 0)
-  * <Animation Name> = [String] # [String]; NB: In this mode, separate texture files are expected for all the frames. The first value defines the animation base file name, the second one defines the file extension. +  * ''Animation'': The first value, optional, defines a name for the animation config template to use, defaults to the key itself. The second value, optional, specifies how many frames should be created: >=> maximum frames to be loaded, -1 => as many frames as can fit inside the whole texture, 0 => as many frames as are defined in config, defaults to -1. 
-  * <Animation Name>-> = {.!+-}Animation1 # {.!+-}Animation2 # ...; NB: Defines all the possible transitions (ie. links) coming from Animation. The optional prefixes are properties for the link: ''.'' means: immediate, ''!'' means: clear target, ''+'' means: high priority, ''-'' means: low priority.+  * ''Animation'': In this mode, separate texture files are expected for all the frames. The first value defines the animation base file name, the second one defines the file extension. 
 +  * ''Animation'': In this mode, an empty animation (with no keys) will be created. 
 +  * ''Animation->'': Defines all the possible transitions (ie. links) coming from Animation. The optional prefixes are properties for the link: . => immediate, ! => clear target, + => high priority, - => low priority. Defaults to looping onto itself if not defined.
  
 === Animation === === Animation ===
Line 66: Line 72:
  
 Here's a list of the available properties for an animation: Here's a list of the available properties for an animation:
-  * ''Texture'': path/to/ImageFile.ext +  * ''Texture'': path/to/ImageFile.ext See GraphicTemplate for more details on this property. If provided, Text property will be ignored. 
-  * ''TextureOrigin'': Defines the origin of the texture from which to get the frames. Defaults to top left corner, ie. (0, 0, 0) +  * ''TextureOrigin'': Defines the origin of the texture from which to get the frames. Defaults to top left corner, ie. (0, 0, 0). Unused in the case of Text animation. 
-  * ''TextureSize'': Defines the size of the texture from which to get the frames. Defaults to the actual physical size of the texture+  * ''TextureSize'': Defines the size of the texture from which to get the frames. Defaults to the actual physical size of the texture. Unused in the case of Text animation. 
 +  * ''Text'': Text animations are supported provided that a Text property is defined at the animation level (here) and no Texture is defined. In this case, the animation should be defined with a value of 0 in the animation set (ie. retrieve frame data from config).
   * ''Direction'': Defines how the frames are read inside the texture. First value defines the direction of the rows, second one the direction of the columns. Defaults to right # down (ie. western writing direction). Examples: left|right|down|up # left|right|down|up   * ''Direction'': Defines how the frames are read inside the texture. First value defines the direction of the rows, second one the direction of the columns. Defaults to right # down (ie. western writing direction). Examples: left|right|down|up # left|right|down|up
-  * ''FrameSize'': Default size of all the frames of this animation +  * ''FrameSize'': Default size of all the frames of this animation. Unused in the case of Text animation. If not defined in the case of a single frame animation, defaults to the same value as TextureSize. 
-  * ''KeyDuration'': Default key duration for all the frames of this animation+  * ''KeyDuration'': Default key duration for all the frames of this animation.
  
  
Line 83: Line 90:
  
 Here's a list of the available properties for an animation frame override: Here's a list of the available properties for an animation frame override:
-  * ''KeyEvent'': Optional. Defines a custom event that will be sent when this key is played. The first value is the event's name, the second one, the event's numerical value, which is optional and defaults to 0.0. +  * ''KeyEvent'': Optional. Defines a custom event that will be sent when this key is played. The first value is the event's name, the second one, the event's numerical value, is optional and defaults to 0.0. 
-  * ''TextureOrigin'': Optional. Overrides the computed origin of the frame. Only define it for manual override.+  * ''TextureOrigin'': Optional. Overrides the computed origin of the frame. Only define it for manual override. If this is defined, FrameIndex will be ignored.
   * ''TextureSize'': Optional. Overrides the default size of the frame (the FrameSize attribute in the animation/Animation Set). Only define it for manual override.   * ''TextureSize'': Optional. Overrides the default size of the frame (the FrameSize attribute in the animation/Animation Set). Only define it for manual override.
 +  * ''FrameIndex'': Optional. Overrides the current frame's texture origin based on the animation's FrameSize and Direction. Only define it for manual override. Ignored if TextureOrigin is defined for this frame.
 +  * ''String'': Optional. Only used for Text animations.
   * ''KeyDuration'': Optional. Overrides the default key duration of the frame.   * ''KeyDuration'': Optional. Overrides the default key duration of the frame.
   * //Any other Graphic property like Pivot or Flip can be used here.//   * //Any other Graphic property like Pivot or Flip can be used here.//
Line 91: Line 100:
 Examples: Examples:
  
-See: [[en:tutorials:animation_walkthrough|Animation Walk-through]].+See: [[en:tutorials:animation:animation_walkthrough|Animation Walk-through]].
  
  
en/orx/config/settings_structure/orxanim.1518583599.txt.gz · Last modified: 2018/02/14 00:46 (6 years ago) (external edit)