File: plug-in-gap-onionskin-configuration.txt

package info (click to toggle)
gimp-gap 2.6.0%2Bdfsg-1
  • links: PTS
  • area: main
  • in suites: squeeze
  • size: 19,656 kB
  • ctags: 7,358
  • sloc: ansic: 119,801; sh: 3,890; makefile: 932; lisp: 97; pascal: 55
file content (251 lines) | stat: -rw-r--r-- 7,823 bytes parent folder | download | duplicates (6)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
"plug-in-gap-onionskin-configuration"

Onionskin Layers:

  Onionskin Layer(s) usually do show previous (or next) frame(s)
  of the video in the current frame.
  The GIMP Video Menu has a submenu named "Onionskin" that provides
  functions to deal with onionskin layers


  Start from Menu:
       <Image>/Video/Onionskin/Configuration...  

       <Image>/Video/Onionskin/Create or Replace
       <Image>/Video/Onionskin/Delete
       <Image>/Video/Onionskin/Toggle Visibility

  

  Onionskin layers are copies of previous or next frames
  of the video. 
  By default they are built by merging the visible 
  layers of the previous frame but without the BG-Layer 
  (and without other onionlayers).
  Onionskin layers are usually placed above the backroundlayer
  in the layerstack of the current frame.  
  
  Onion Layers are normally used for display of the previous
  scene when painting moving characters.
  They behave like a normal layer, but you can toggle
  visibility or delete onionskin layers
  with Functions provided by this module.
    

Configuration:
  In the onionskin configuration dialog window you can
  - edit the settings for creation of onionskin layers
  - apply the settings to a selected range of frames
  - delete onionskin layers in a selected range of frames.


  Reference Mode:
      NORMAL             /* default */
         The Frame Reference Parameter is used as delta
	 in just one direction.
	 Negative values refere to previous frames only,
	 positive values refere to next frames only.
      BIDRIECTIONAL_SINGLE
         The Frame Reference Parameter is used as 
	 bidirectional delta in both directions
	 With an inital Frame Reference offset -1
	 the reference sequence is
	 -1, +2, -3, +4, -5, +6, ...
	 
      BIDRIECTIONAL_DOUBLE
         The Frame Reference Parameter is used as 
	 bidirectional delta in both directions
	 With an inital Frame Reference offset -1
	 the reference sequence is
	 -1, +1 -2, +2, -3, +3, ...
    
    
  Onionskin Layers:
     Defines how many onionlayers will be created in
     the current image.
         
  Frame Reference:
     Stepsize to reference the source framenumber
     from where we copy the onionlayer.
     Examples:
         -1  .. copy 1.st onionlayer from current framenumber -1
                copy 2.nd onionlayer from current framenumber -2
                
         +2  .. copy 1.st onionlayer from current framenumber +2
                copy 2.nd onionlayer from current framenumber +4

         The example assumes Reference Mode NORMAL.

  Cyclic (Togglebutton):
     Define fold back behavior when referencing previous
     or next frames:
     ON:  last frame has frame 0 as next frame.
     OFF: last frame has NO next frame.

  Stackposition:
     Position where to place onionlayer(s) in the layerstack.

  From TOP (Togglebutton):
         ON: Stackposition is counted from top (0 is on top)
         OFF: Stackposition is counted from bottom (0 is on bottom)

  Opacity:
     The 1.st onionlayer is created with this
     opacity seting (100 is full opaque, 0 is full transparent)

  Opacity Delta:
     100 : The 2.nd onionlayer is created with same
           opacity as the 1.st onionlayer.
     80  : The 2.nd onionlayer is created with 
           80% of the opacity of the 1.st onionlayer,
           The 3.rd with 80% of the 2.nd  and so on...
 
  Ascending Opacity (Togglebutton):
     ON: the farest handled Neighbour Frame has the
         highest Opacity (the Primary Opcaty defined above)
         This may be used to create cross-fading effects.
         (*) see cross-fading example settings below.
             
     OFF: the nearest handled Neighbour Frame has the
          highest Opacity, Opacity is descending
          for the other frames at farer distance.
          This should be used for regular Onionskin usage.

 
  Options how to merge the previous Layer into one Onionlayer:
  
      Restrict by Layernames:  Default '*'  all Names.
         Here you can specify a layernamepattern.
         only layers with matching names are included
         in the onionlayer.
      
      Ignore BottomLayer(s):   Default 1
         Here you can exclude the background layer (1)
         or n layers counted from the bottom of the
         layerstack from the merged copy of the frame
         that makes up the onionlayer.
        
  
  

  
  Auto Create after Load
       ON: Force automatic Creation (or Replacement) of Onionskin Layer(s)
           on GAP controlled Framechanges.
  Auto Delete before Save
       ON: Force automatic Delete of Onionskin Layer(s)
           on GAP controlled Framechanges.

           GAP controlled Framechanges are GoTo Operations in the Video Menu
           or in The Video/VCR Navigator Dialog or in the Video/Playback
           dialogs.




  The Buttons:    

  APPLY:
    The apply button creates onion layers in the selected range
    of frames and sets the values for the handled Animation.

  DELETE:
    The delete button removes onion layers in the selected range
    of frames and sets the values for the handled Animaton.
    

  CLOSE:
    This button Closes the window and sets the values for the current
    handled Animation, without changing any frame.
    
    
  DEFAULT:
    Load hardcoded defaults (does not set anything)
    

  SET for <name_of_the_current_animation>:
    This button sets the values for the current
    handled Animation.




Restrictions:

   - The Onionskin automatic does NOT work if you load a frame
     via the File Menu, or othe implicite file load/save operations.
   
   - Onionskin Layers are restricted to Imagefortmats that can store
     multiple layers, layer parasites and tattoos.

     GIMP's native format XCF is rcommanded.



Onionskin Functions:

  The other functions in the Video/OnionskinLayer menu
  do not open dialog windows. 
  They are intended for quick use, and it is recommanded
  to assign key-shortcuts if you want to use them
  frequently.
  ### here we should refere to gimp docs howto assign key-shortcuts ###
  
  
  Create or Update Onion Layers:
       Create onionlayers in the current frame,
       according to the configurated settings.
       (see above)
  
  Toggle Visibility:
       Turn visibilty on (or off) for all onionlayers.

  Delete Onion Layers:
       Remove all onionlayers from the current frame.
 
       Note: if you made a copy of an onionlayer manually
             the copy should not be deleted.
             If you have gimp-1.2.2 the copy will be deleted too,
             because there is a bug in the gimp video base functions.




Tips:  Cross-Fading Example

   With special Onionskin  Settings you can get Cross Fading Effects.
   
   An animation was created with a Framerate of 8 f/sec
   and should playback on a target rate of 24 f/sec
   
   As 1.st step you need to duplicate all the frames in a way like this:
   
   01  02  03  04 ...            original squence
   
   01  02 03   04 05 06   07 08 09   10 11 12 ....   new numbers
   01  01 01   02 02 02   03 03 03   04 04 04 ....   (old original numbers)
   
   Use the Menu  <Image>/Video/Frames Density... for this task.
   

   To to improve smoothness, you can use Onionskin Layers
   to show 1 and 2 frames ahead on top of the Layerstack.
   
   In The 2.nd Step You create Onionskin Layers in all resulting Frames
   with the following Settings:
   
   Onionskin Layers: 2      Ascending Opacity: ON
   Frame Reference:  1      Cyclic:            OFF
   Stackposition:    0      From Top:          ON
   Opacity:          66.6   50.0
   
   Ignore BG-layer(s): 0        // do not ignore any Layer
   
   From Frame: 1
   To Frame  : the last frame of your animation
  


  When you wan equally balanced Opacity
  you should use Opacity 1/3 for each frame
  33.3 %, 100%