ST_cameraMask 1.0 for Maya (maya script)

This script creates a black frame around your cameras frame if the filmgate or the resolution gate is enabled. This is practical if you have to layout a shot and want to see only whats inside of the frame.

Additionally, you will get some parameters on the cameras transform which allow you to change the overscan value and the camera masks alpha value, to make it slightly see through for example. The limitations are as follows:

# It will only work if the horizontal aperture is wider than the vertical aperture. If this ratio swaps, the results will be unpredictable

# Dependent on the cameras nearClipPlane, sometimes you see the outline of a square, which seems to be a bug of the Maya image plane. To fix this, you can change the nearclipplane to a value which seems to work

# With some aspect ratios, there may be some pixels lapping into the actual frame. Try to adjust the overscan to get rid of the problem

# Only aspect ratios larger than 1 lead to properly scaled camera masks. This means, that if the horizontal aperture is smaller than the vertical one, the camera mask will not fit anymore

# If you rename a camera with a camera mask applied to it, this will only be handled properly if you called ST_cameraMask at least once in the maya session since a scriptjob has to be initialized first.
This scriptjob initialization could be moved to the userSetup.mel to make sure it gets called when Maya starts up, which would eliminate this potential problem.

View Readme