Navigation: Sources > Ray Positions > Bitmap

 

Bitmap

 

Contact Us: fredsupport@photonengr.com

 

 

 

Description


The Bitmap ray positions specification uses a *.jpg or *.bmp file as a source grid for ray emission and weighting.  This source specification is valid only for visible wavelengths.  Creation of the source grid proceeds in the following way:

 

1.

The designated number of rays per pixel have their positions randomized within each pixel in the image file.

2.

The chromaticity coordinates for the pixel are calculated.

3.

The wavelengths present in each pixel have their weights solved to match the chromaticity coordinates in that pixel.

4.

Each ray's solved weight is multiplied by the weight factor specified in the Wavelength tab of the source dialog.  For the true representation of the bitmap, leave the wavelength weights at 1 in the wavelength list

 

The following conditions are applied depending on the number of wavelengths being used:

Fewer than 3 wavelengths: The wavelength weights are given by the pixel's intensity (y-tristimulus) value, regardless of the wavelength.

Greater than 3 wavelengths: Color synthesis is used to set the wavelength weights for the given pixel.

 

As an example, the source shown below was synthesized with 10 wavelengths spanning the visible.

 

 

 

Navigation


This feature can be accessed by selecting Bitmap (points defined by bitmap pixels) as the ray position type on the Positions/Directions tab of a detailed source dialog box.

 

 

Controls


Control

Inputs / Description

Defaults

Type

File Name

Name of bitmap file: (*.bmp or *.jpg)

 

Parameters

Rays/pixel

Number of rays per pixel (per wavelength)

1

Semi-width/height

Sets the source dimensions.

0.5, 0.5

Center X Y Z

Sets the source's center position.

0,0,0

 

OK

Accept settings and close dialog box.

 

Cancel

Discard settings and close dialog box.

 

Apply

Apply settings and keep dialog box open.

 

Help

Access this Help page.

 

 

 

Application Notes


Specifying source wavelengths

Source wavelengths are set on the Wavelengths tab of a detailed source dialog and can usually be specified by either a list of wavelengths or a spectrum.  In the case of the bitmap source, the spectrum option is disabled when the Bitmap ray positions type is being used.  Standard RGB wavelengths can be set in the wavelength list by right mouse clicking in the wavelength list spreadsheet and selecting "Set Standard Bitmap Wavelengths" from the list menu.  Depending on the application, more than three wavelengths may be desirable.  For example, will the rays be passing through a filter?  Is the number of wavelengths specified sufficient to accurately represent passage through the filter?

 

As mentioned in Step 4 in the Description section, the wavelength weights are applied at the end of the pixel color synthesis process.  If a true color image of the bitmap is desired, the wavelength weights should be set to 1.  If additional scaling is desired, the wavelength weights should be modified.

 

Related Topics


Ray Positions - Bitmap

Ray Positions - Grid Plane

Ray Positions - Hexagonal Plane

Ray Positions - Read rays from a file

Ray Positions - Random Plane

Ray Positions - Random String

Ray Positions - Random Volume

Ray Positions - User-defined Rays

 

 

 

 

 

Copyright © Photon Engineering, LLC