Exposure

Capture Parameters

Controls capture of an exposure image.
Used in /exposure load and /exposure expose commands.

Structure:

PropertyType or Possible ValuesDescriptionDefault
idStringPoints to the .dat file in <world>/data/exposures.-required-
fovFloat(>0)Sets the fov to this value if specified-
crop_factorFloat(>0 to 1)How much an image would be cropped. Camera uses 0.8751.0
filterResourceLocationShader that will be used-
projectionProjection Info (see below)Image loading properties-
single_channelred, green or blueIf film_type is black_and_white, image will consist of data from single channel-
film_propertiesFilm Properties (see below)Some attributes of the image-
extra_dataExtra Data (see below)Additional info sent to the client-

All of the properties are optional, except id.

Projection Info

PropertyType or Possible ValuesDescriptionDefault
pathStringFile path or URL-required-
modedithered or cleanControls whether the image would be dithereddithered

Film Properties

PropertyType or Possible ValuesDescriptionDefault
typecolor or black_and_whiteType of the filmcolor
frame_sizeInteger(1 to 2048)Resolution of the image'default_frame_size' from server config
color_paletteResourceLocationPalette that will be used to sample colors"exposure:map_colors_plus"
styleFilmStyle (see below)"Editing" of the image-

Film Style

PropertyType or Possible ValuesDefault
sensitivityFloat(-10 to 10)0
contrastFloat(-1 to 1)0
levelsLevels (see below)-
hsbHSB (see below)-
color_balanceColorBalance (see below)-
noiseFloat (0 to 1)0

Levels

PropertyTypeDefault
shadowsInteger(0 to 255)0
midtonesInteger(0 to 255)128
highlightsInteger(0 to 255)255
blackInteger(0 to 255)0
whiteInteger(0 to 255)255

HSB

PropertyTypeDefault
hueFloat(-1 to 1)0
saturationFloat(-1 to 1)0
brightnessFloat(-1 to 1)0

ColorBalance

PropertyTypeDefault
redFloat(-1 to 1)0
greenFloat(-1 to 1)0
blueFloat(-1 to 1)0

Extra Data

PropertyType or Possible ValuesDescriptionDefault
shutter_speedStringAffects brightness of the image1/60
flashtrue or falseSpawns flash particlesfalse