CombineZM Help

Macro Commands

Command

Brief Description

Add Params(p1,p2,p3)

p3=p1+p2

Add Rectangles(factor)

result=A1+(factor/1000)*A2

Sum Rectangles from 2 Frames put result in Out.

Adjust Colour and Brightness(red,green,blue)

<1000 reduce, >1000 increase

Alter red, greren, and blue tint and brightness of a rectangle in 1 frame result in Out

Adjust Contrast(factor)

factor=0 for no change

Alter Contrast of one Frame result in Out.

Align all Frames Automatically (Single pass)

Align and resize frames so that neighbouring frames match

Align all Frames Automatically (Two pass)

First resize then resize and align all frames so that neighbours match, use when frames are shot at regular intervals.

Alter Brightness of Filter Output(factor)

factor<100 decrease >100 increase

When ZV approaches zero you may need to brighten filter outputs.

Auto Align& (Astronomical)(max degrees x 100)

Align frames that are all in focus, may include rotation 

Balance Colour and Brightness (Global)

Make the average colour and brightness of consecutive frames the same, the average is over the whole frame.

Balance Brightness

Make the average brightness of consecutive frames the same, the average is over the whole frame.

Balance Colour and Brightness (Local)

Make the local average colour the same in neighbouring frames. 

Balance Colour Only

Local Balance of Colour without affecting brightness.

Blend Rectangles(factor)

result=(1-factor/1000)*A1+(factor/1000)*A2

Mix two frames in varying proportions, optionally replace Active Frame.

Clean Start

Shorthand for Use All Frames, Select All, Normal Filter Output

Clear Active Rectangle

Clear the whole Active Rectangle including Fixed Pixels.

Clear Unfixed Active Rectangle

As the name states.

Convert Stack to Monochrome

Convert the stack to monochrome with colour weighting, i.e. set red, green and blue components to the same value.

Copy Active To Out

Make a straight copy of the Active Frame in Out.

Correct Brightness(factor)

factor=1000, use reference as is 

Work out what must be done to each pixel of a reference frame to make it equal to the average colour of the whole frame, then do the same to the active frame result in Out.

Correct for Brightness in Z Direction

Check for maximum and minimum local brightness up an down the stack for every Pixel in the Picture, correct Depthmap and Picture as necessary.

Create a Bandpass Filter(width,center)

upper left 0<=width or center<=1000 lower right

Create a Filter that emphasizes one band of frequencies.

Create a Bandstop Filter(decayw,bandw,center)

0<=decayw or bandw<=1000 from top left and bottom right, bottom right 0<=center<=1000 top left

Create a Filter that suppresses a band of frequencies.

Create a Butterworth Filter(width,center,shape)

top left 0<=width or center<=1000 lower right, shape=1+ small integers

Create a Filter that emphasizes a group of frequencies, asymmetrical.

Create a Highpass Filter(width,start)

lower right 0<=width or start<=1000 upper left, width begins after start

Create a Filter that Sharpens

Create a Lowpass Filter(width,start)

upper left 0<=width or start, start<=1000 lower right, width begins where start ends

Create a Filter that softens or reduces noise.

Devide Params(p1,p2,p3)

p3=p1/p2

Do Not Use Frame

Mark the Active Frame with '*' so it will not be used by stacking functions.

Do Not Use Frames Above

Mark all frames above the Active Frame with '*'  so it will not be used by stacking functions.

Do Not Use Frames Below

Mark all frames below the Active Frame with '*'  so it will not be used by stacking functions.

Enhanced Average to Out(Low,High,Brighten)

Low 0+, High 0+, Brighten 1000=none

Computes the Average of all Used Frames with optional Low light gain and High light attenuation.

External Command(a,b,c)

a, b and c three numbers passed at end of command line

Start an external program passing information to it, can be used to take pictures, control motors, lights etc.

Fill Gaps

Calculate likely values for the Depthmap at Empty Pixel locations, then place the corresponding Pixels in the Picture.

Filter Active Frame

Use the last created Filter on the Active Frame result in Out.

Filter All Frames

Use the last created Filter on all Used Frames and replace them with the filtered output, Out is destroyed.

Filter and Replace Depthmap

Filter the Depthmap then replace it with the result, and then redraw the Picture.

Filter Corrected Weighted Sum

Uses Top Frame as default, and weighted Sum for ambiguous pixels

Filter Depth Map

Filter the Depthmap but do not replace it, result in Out.

Filter Sum of Stack

Add all frames into the DFT input buffers then Filter with the last created Filter, the result is scaled to normal frame brightness the placed in Out.

Filter weighted sum of stack

As above but multiply each pixel by a value that reflects the likelyhood that it should be in the finished picture before it is summed.

Find Detail(threshold)

0<=threshold higher values find less detail, lower values more noise

Look for the most likely pixel that should go into the Picture at each x,y location then put it's Frame number in the Depthmap and its colour in the Picture.

Find Lightest and Darkest Pixels(L_threshold,D_threshold)

more detail 0<L_threshold or D_threshold<=255 less detail

At each x,y location find the darkest or lightest pixel and place it in the picture and it's Frame number in the Depthmap, there are light and dark thresholds associated with this function.

Finish

Use after filtering, altering colour and brightness etc. if you do not wish the user of a macro to be ably to carry on altering the result via the last tool or filter invoked.

Fix

Fix pixels in the Active Rectangle so that Stacking Functions will not alter them.

Go (Relative) to Frame(n)

0<=A1+n<=Top Frame, if A1+n goes out of bounds Macro ends 

Add or subtract a number from the current Active Frame to arrive at a new one.

Go to Frame(f)

0<=f<=Top Frame, if f goes out of bounds macro ends

Make the Active Frame equal to a fixed number.

Goto Frame1

Make the Active frame equal to the first Remembered Frame

Goto Frame2

Make the Active frame equal to the second Remembered Frame

Goto Top Frame

Make the Active Frame equal to the Top Frame in the Stack

Insert Above Active

Make a new Frame above the Active Frame and copy Out into it

Insert Below Active

Make a new Frame below the Active Frame and copy Out into it

Interpolated Output

Use fractional values stored in the Depthmap to 'Smoothe' the Picture, the result will be in Out.

Invert Fixed/Unfixed in Picture

Make Fixed into Unfixed pixels, and Unfixed ones into Fixed.

Macro 1 … Macro 10(start,step,end)

pass start first, then start+step etc. until >end

Execute a macro, note the names will be supplied by the writer of the macros.

Make a new Frame from Out

Create a new frame at the top of the Stack and copy Out to it, the Active Frame is not changed.

Make a new Frame from Picture

Create a new Frame at the top of the Stack and copy the Picture into it, the Active Frame is not altered.

Make Active Frame 2

Make the Active Frame into Active Frame 2 also, this frame is used as input to functions that use two frames.

Make Black in Frame Transparent

Make Black Pixels in the Active Frame transparent, useful for overlays.

Make Patchwork(size,threshold)

1<=size=length of side of square patch. 0<=threshold larger values select less

Like Find Detail but uses a larger samplple area to work out likely Patches rather than Pixels.

Multiply Params(p1,p2,p3)

p3=p1*p2

Normal Filter Output

Cancel any Brightening of Filter outputs.

Output the Active Frame

Save Active Frame to Output folder as .jpg, .bmp, .tif, .gif or .png.

Paste Active Rectangle Over Picture

Copy Active Frame to Depthmap and Picture, allowing original Picture to show only through Transparent patches in Frame.

Paste Active Rectangle Under Picture

Copy Active Frame to Picture and Depthmap, do not overwrite occupied pixels, only fill Empty ones.

Process Monochrome Stack

Speed up processing of monochrome stacks by only processing the Red channel then copying this to Green and Blue.

Reload All Frames

Reload all Frames from the Work Folder, these must have been previously saved.

Reload Depthmap

Reload the Depthmap from the work folder, this must have been saved previously.

Remember Frame1

Remember the position of the current Active Frame as Frame1

Remember Frame2

Remember the position of the current Active Frame as Frame2

Remove Active Frame

Delete the Active Frame from the Stack, higher frames move down, the Active Frame keeps the same number which now refers to the Frame above that which was deleted.

Remove Colour Steps

An attempt to remove abrupt changes in colour, not very good.

Remove Islands(size)

1<=size=number of pixels in an isolated patch.

Remove small patches of Pixels from Picture and Depthmap, a patch is surrounded by no pixels or pixels from other Frames.

Replace Frame with Out

Overwrites the Active Frame with Out.

Replace Frame with Picture

Overwrites the Active Frame with the Picture.

Replace Groups(size)

2<=size=number of Frames in each group.

Replaces groups of Frames with a single Frame, the groups are all the same size, the single Frame is thew average of the whole group.

Resize all Frames (Regular steps)(factor)

factor/10000=magnify by 1

Go up and down the Stack from the Active Frame resizing all Frames in regularly increasing amounts as they get further away from the Active Frame.

Restart Macro

Go back to the first line of the current Macro

Reverse Order of Frames

Reverse the order of the Frames in the Stack.

Save All Frames

Save all Frames in the work folder for Reloading later.

Save Depthmap

Save the Depthmap in the work folder for reloading later.

Select All

Make the Active Rectangle equal to the whole picture.

Skew Stack(pixels+1000)

if pixels<0 left, pixels>0 right

Move Frames Left or Right progressively greater amounts up the Stack.

Start Hours Timer(hours)

Start a Timer for a fixed number of hours.

Start Minutes Timer(minutes)

Start a Timer for a fixed number of minutes.

Subtract Params(p1,p2,p3)

p3=p1+p2

Take a Picture

Take a Picture, add as a new Frame to top of Stack

Threshold Filter Output

Brightness threshold, black and white, filter output

Unfix

Unfix all Fixed pixels in the Active Rectangle of the Picture. 

Use All Frames

Remove '*' from all frames so that all stacking operations will work on all Frames.

Use Frame

Remove '*' from current Active Frame so that it can be used for stacking. 

Wait for Timeout

Wait until a previously set Timer expires.

Home Page