Album

MAlbum

Album and MAlbum functions create a resized photo image on the base clip. The base clip on which this is to be created, the clip and frame numbers from which this image is to be created, corresponding base clip start frame number and end number are to be specified. Positioning of the photo can be at preset position or at any user defined position. The photo can be from full input frame or a portion of it. Even though the image can be enlarged, as point resizing is used, enlargement will degrade quality and to be avoided. Audio of base clip only is retained. If video frame is positive number, then a still image from the specified frame is created. If negative, full motion resized video is created in that specified position, starting from its frame number.


RGB32, RGB24, YUY2 and YV12 formats only are supported.

It may be noted that in the parameters description table,
In case preset = true, parameters 10 to 17 (inxl to outyb) are ignored.
In case of presets, the photo size is suitably adjusted to occupy the positions:
If nphotos=1 then only one position, 1 is possible and it is central on frame.
If nphotos are from 2 to 4, preset 1 to 8 thumbnail placement positions are possible as below. All of them are of same size. In case of 5 to 8 only two photos of that size are possible (either 5 and 6 or 7 and 8).

Preset 1 Preset 2
Preset 3 Preset 4
........ Preset 5 ........
........ Preset 6 ........
........ ........
Preset 7 Preset 8
........ ........

If nphotos are between 5 to 9 then the following 1 to 9 preset positions are possible for thumbnail placement.
Preset 1 Preset 2 Preset 3
Preset 4 Preset 5 Preset 6
Preset 7 Preset 8 Preset 9

If nphotos are between 10 and 16 the preset positions are as below.
Preset 1 Preset 2 Preset 3 Preset 4
Preset 5 Preset 6 Preset 7 Preset 8
Preset 9 Preset 10 Preset 11 Preset 12
Preset 13 Preset 14 Preset 15 Preset 16

And so on. It's possible to specify nphotos other than actually present, to place that particular photo in a desired position and with a different size. Care to be taken that it may not mask out others. This Album function needs to be called once for each photo. In the first of series of calls to Album, the BaseClip can be any desired clip but for the rest it needs to be specified as last. If photos are taken from same video clip, reverse seek can slow down process.

Details of parameters
Description Name Type Limits Default
base clip clip none
video clip clip none
Are thumbnails to be at preset positions? preset boolean true for yes, false for user defined none
number of photos in this album page nphotos integer 1 to 16 9
Preset position number at which thumbnail to be placed position integer 1 to 16 1
starting frame number of base clip when this thumbnail appears startframe Integer within clip 0
end frame number of base clip for this thumbnail endframe Integer within clip, more than startframe last frame of base clip
frame number(starting) of video clip to use for thumbnail photoframe integer within video clip. If +ve still photo. If -ve resized video 0
border border width on each side of thumbnail Integer 1/40 of minimum frame dimension 4
left x coordinate of video frame part to generate thumbnail inxl integer within frame 0
top y coordinate of video frame part to generate thumbnail inyt integer within frame 0
right x coordinate of video frame part to generate thumbnail inxr integer within frame, greater than inxl frame width-1
bottom y coordinate of video frame part to generate thumbnail inyb integer within frame, greater than inyt frame height-1
left x coordinate of base frame at which thumbnail is placed outxl integer within frame inxl
top y coordinate of base frame for thumbnail placement outyt integer within frame inyt
right x coordinate of base frame for thumbnail appearance outxr integer within frame, greater than inxl inxr
bottom y coordinate of base frame for thumbnail appearance outyb integer within frame, greater than inyt inyb
merge width %age for MAlbum function only merge integer 0 to 100 20

#Usage examples:-
This script results in n thumbnails display at preset positions
n=6
Clip1=Avisource("------.avi")
Clip2 = Avisource("____.avi")
…………………………..
Clipn=Avisource("------.avi")
# ensure same frame characteristics
Base=blankclip(clip1, length=1000)
Album(base, clip1, true,n,1,50,800,0,4)
Album(last, clip2, true,n,2,100,850,0,4)
Album(last, clip3, true,n,3,150,900,50,4)
………………………………………..
Album(last, clipn, true,n,n,100,900,70,4)

#The following script for different preset sizes of photos display
#Note use of different values of nphotos
Clip1=Avisource("------.avi")
…………………………..
Clip6=Avisource("------.avi")
Base=blankclip(clip1, length=1000)
Album(base, clip1, true,2,1,100,900,0,4)
Album(last, clip2, true,8,3,100,900,0,4)
Album(last, clip3, true,8,6,100,900,50,4)
Album(last, clip4, true,8,7,100,900,0,4)
Album(last, clip5, true,8,8,100,800,50,4)

Album(last, clip6, true,8,9,100,900,50,4)
or
MAlbum(base, clip1, true,2,1,100,900,0,4/merge=10)
MAlbum(last, clip2, true,8,3,100,900,0,4,merge=15)
MAlbum(last, clip3, true,8,6,100,900,50,4,merge=25)
MAlbum(last, clip4, true,8,7,100,900,0,4)
MAlbum(last, clip5, true,8,8,100,800,50,4)

MAlbum(last, clip6, true,8,9,100,900,50,4,merge=40)

The following script for user defined size and position of photo display
Clip1=Avisource("------.avi")
Clip2 = Avisource("____.avi")
…………………………..
Clip6=Avisource("------.avi")
Base=blankclip(clip1, length=1000)
Album(Base, clip1, false,startframe=100,endframe=900,photoframe=50,inxl=100,inyt=100,inxr=400,inyb=300,outxl=300,outyt=200,outxr=400,outyb=300)
…………………

#photo position or start and end frames can be different for each Album call. 

…………..
Album(last, clip3, true,8,6,100,300,50,4)
Album(last, clip6, true,8,2,400,900,50,4)

# One or more or all of the photos can be video motion and rest still photos

Album(base, clip1, true,2,1,100,900,-1,4)
Album(last, clip2, true,8,3,100,900,0,4)
Album(last, clip3, true,8,6,100,900, 50,4)
Album(last, clip4, true,8,7,100,900,-10,4)
Album(last, clip5, true,8,8,100,800,50,4)



Image with effect :
Back to HollywoodSq.
down load HollywoodSq plugin
Back to my plugins page
back to Avisynth