?? mzdde function reference.html
字號:
<html><head><meta http-equiv="Content-Language" content="en-us"><meta http-equiv="Content-Type" content="text/html; charset=windows-1252"><title>MZDDE Function Reference</title></head><body><P><A name = "MZDDE"><H2>MZDDE</H2></A><PRE> ZEMAX DDE Server Toolbox ZEMAX DDE Server Toolbox Version 2 Provides access to ZEMAX functionality from <A href = "http://www.mathworks.com">Matlab</A>. NOTE : The ZEMAX DDE server maintains an independent copy of the lens from the Lens Data Editor (LDE). See <a href = "#zPushLens">zPushLens</a> and <a href = "#zGetRefresh">zGetRefresh</a> for moving lens data between the DDE server and the LDE. For further details, see the chapter on "ZEMAX Extensions" in the ZEMAX manual. Before calling any functions that access the ZEMAX DDE server, it is necessary to initialise the DDE link using the <a href = "#zDDEInit">zDDEInit</a> function. Failure to do so will cause <A href = "http://www.mathworks.com">Matlab</A> to issue a verbose yet completely uninformative error message. This toolbox is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version. This toolbox is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License (in the file <A href = "../COPYING.html">COPYING</A>) for more details. Report bugs and updates to <A href = "mailto:dgriffith@csir.co.za">Derek Griffith</A> List of Functions - Function names are case insensitive. <a href = "#ACCOSin">ACCOSin</a> - ACCOS LENO format importer for ZEMAX. <a href = "#BIMwrite">BIMwrite</a> - Write ZEMAX format binary greyscale image. <a href = "#Census">Census</a> - Provides a listing of all functions in this toolbox, along with current revisions. <a href = "#deg2rad">deg2rad</a> - Converts degrees to radians. <a href = "#digitize">digitize</a> - A script to <a href = "#digitize">digitize</a> data from an image of a graph. Author J. Cogdell. Not MZDDE. <a href = "#LSF">LSF</a> - Diffraction-limited Monochromatic Line Spread Function. PLSF - Diffraction-limited Polychromatic Line Spread Function. <a href = "#MTF">MTF</a> - Diffraction-limited Monochromatic Modulation Transfer Function. <a href = "#PMTF">PMTF</a> - Diffraction-limited Polychromatic Modulation Transfer Function. <a href = "#Planck">Planck</a> - <a href = "#Planck">Planck</a> black body function. <a href = "#PlotZemaxOTF">PlotZemaxOTF</a> - Plot a thru-frequency MTF/OTF as returned by <a href = "#ReadZemaxOTF">ReadZemaxOTF</a> or <a href = "#zGetMTF">zGetMTF</a>. <a href = "#PSF">PSF</a> - Diffraction-limited Monochromatic Point Spread Function. <a href = "#PPSF">PPSF</a> - Diffraction-limited Polychromatic Point Spread Function. <a href = "#PSF2D">PSF2D</a> - 2D Image of the Diffraction-limited Polychromatic Point Spread Function. <a href = "#rad2deg">rad2deg</a> - Converts radians to degrees. <a href = "#RayDevParPlate">RayDevParPlate</a> - Computes lateral deviation of a ray passing through a plane parallel plate. <a href = "#ReadCIE">ReadCIE</a> - Read CIE data into workspace variables (colour observers, daylight etc.) <a href = "#ReadZemaxGImAnal">ReadZemaxGImAnal</a> - Reads data from a ZEMAX Geometric Image Analysis text data file. <a href = "#ReadZemaxIllum">ReadZemaxIllum</a> - Reads data from a ZEMAX Uniformity of Illumination Analysis test file. <a href = "#ReadZemaxOTF">ReadZemaxOTF</a> - Reads data from a OTF/MTF text file from ZEMAX (thru-frequency, thru-focus or thru-field). <a href = "#ReadZemaxRMS">ReadZemaxRMS</a> - Reads data from a ZEMAX RMS Analysis - Spot Size, Wavefront or Strehl Ratio. <a href = "#ReadZemaxVignet">ReadZemaxVignet</a> - Reads data from a ZEMAX Vignetting Analysis text file. <a href = "#ReadZemaxWaveMap">ReadZemaxWaveMap</a> - Reads data from a Wave Map text data file generated by ZEMAX. <a href = "#SpiralSpot">SpiralSpot</a> - Compute image plane trajectory of a ray scanned in a spiral over the pupil. <a href = "#NarcWiz">NarcWiz</a> - A wizard for performing narcissus analysis on staring infrared cameras. <a href = "#n_air">n_air</a> - Refractive index of air over wavelength, temperature and pressure. <a href = "#DoublePass">DoublePass</a> - Put a lens system into double pass. <a href = "#genRayDataMode0">genRayDataMode0</a> - Generate grid of ray data ready for <a href = "#zArrayTrace">zArrayTrace</a> mode 0. <a href = "#gridXYRayData">gridXYRayData</a> - Generate basic grid of ray data for <a href = "#zArrayTrace">zArrayTrace</a>. <a href = "#IntSphere">IntSphere</a> - Compute the spectral radiance of an integrating sphere given input spectral flux. <a href = "#Onion">Onion</a> - Split lens into layers for analysis of axial temperature gradients. <a href = "#SagEvenAsphere">SagEvenAsphere</a> - Computes the sag of a standard ZEMAX even aspheric surface. <a href = "#WriteZemaxWaveFile">WriteZemaxWaveFile</a> - Write a list of wavelengths and weights in ZEMAX .wav file format. <a href = "#zArrayTrace">zArrayTrace</a> - Performs tracing of large numbers of rays in ZEMAX. <a href = "#zDDEBusy">zDDEBusy</a> - Checks to see if the ZEMAX DDE server is busy. <a href = "#zDDEClose">zDDEClose</a> - Close DDE communications channel to ZEMAX. <a href = "#zDDEInit">zDDEInit</a> - Open communications channel to ZEMAX DDE server. <a href = "#zDDEStart">zDDEStart</a> - Attempt <a href = "#zDDEInit">zDDEInit</a>. If no ZEMAX running, attempt to start ZEMAX. <a href = "#zDeleteSurface">zDeleteSurface</a> - Delete a lens surface. <a href = "#zExportCAD">zExportCAD</a> - Export lens CAD data (IGES, STEP, SAT) to a file. <a href = "#zExportCheck">zExportCheck</a> - Check if lens CAD export has completed. <a href = "#zFindLabel">zFindLabel</a> - Find integer label attached to a lens surface using <a href = "#zSetLabel">zSetLabel</a>. <a href = "#zFixSurfaceData">zFixSurfaceData</a> - Set lens surface data to 'fixed' mode. <a href = "#zFixAllSurfaceData">zFixAllSurfaceData</a> - Set all lens surface data to 'fixed' mode. <a href = "#zGetAddress">zGetAddress</a> - Get address line in Preferences/Address. <a href = "#zGetAspect">zGetAspect</a> - Get the aspect ratio of ZEMAX graphics or print windows. <a href = "#zGetBuffer">zGetBuffer</a> - Get DDE client specific data from a ZEMAX window being updated. <a href = "#zGetCoatings">zGetCoatings</a> - Get a list of available coatings from the ZEMAX COATINGS.DAT file. <a href = "#zGetConfig">zGetConfig</a> - Get current lens configuration, number of configurations and configuration operands. <a href = "#zGetDate">zGetDate</a> - Get current date from ZEMAX DDE server. <a href = "#zGetExtra">zGetExtra</a> - Get single extra data value from ZEMAX DDE server. <a href = "#zGetField">zGetField</a> - Get data on lens field points. <a href = "#zGetFile">zGetFile</a> - Get the filename of the currently loaded lens. <a href = "#zGetFirst">zGetFirst</a> - Get first order data about the lens. <a href = "#zGetGlass">zGetGlass</a> - Get data on a glass at a particular lens surface. <a href = "#zGetGlassCats">zGetGlassCats</a> - Get a list of available text glass catalogues from the ZEMAX Glasscat directory. <a href = "#zGetGlobalMatrix">zGetGlobalMatrix</a> - Get transformation matrix from local surface coordinates to global lens coordinates. <a href = "#zGetIndex">zGetIndex</a> - Get index of refraction data at a lens surface. <a href = "#zGetLabel">zGetLabel</a> - Retrieve integer label associated with a surface. <a href = "#zGetMetaFile">zGetMetaFile</a> - Create Windows Metafile of a ZEMAX graphic analysis window. <a href = "#zuiGetMetaFile">zuiGetMetaFile</a> - As for <a href = "#zGetMetaFile">zGetMetaFile</a>, but with Save As dialog box. <a href = "#zGetMulticon">zGetMulticon</a> - Get data from the ZEMAX multi-configuration editor. <a href = "#zGetMTF">zGetMTF</a> - Get <a href = "#MTF">MTF</a> computation from ZEMAX for current lens. Returns as for <a href = "#ReadZemaxOTF">ReadZemaxOTF</a> function. <a href = "#zGetName">zGetName</a> - Get the name of the lens in ZEMAX. <a href = "#zGetNSCData">zGetNSCData</a> - Get number of NSC objects. <a href = "#zGetNSCObjectData">zGetNSCObjectData</a> - Get data describing NSC objects in ZEMAX. <a href = "#zGetNSCPosition">zGetNSCPosition</a> - Get position data for an NSC object in ZEMAX. <a href = "#zGetNSCParameter">zGetNSCParameter</a> - Get numeric parameters associated with an NSC object in ZEMAX. <a href = "#zGetNSCSettings">zGetNSCSettings</a> - Get ZEMAX settings affecting raytracing in non-sequential components. <a href = "#zGetOperand">zGetOperand</a> - Get data from the ZEMAX Merit Function editor. <a href = "#zGetOperandMatrix">zGetOperandMatrix</a> - Get the entire merit function matrix from the Merit Function Editor. <a href = "#zGetPath">zGetPath</a> - Get the path for the ZEMAX installation directory and lens directory. <a href = "#zGetPolState">zGetPolState</a> - Get the default polarization state from ZEMAX. <a href = "#zGetPupil">zGetPupil</a> - Get data on the aperture stop and pupils. <a href = "#zGetPolTrace">zGetPolTrace</a> - Perform a full polarization raytrace through the ZEMAX lens. <a href = "#zGetPolTraceDirect">zGetPolTraceDirect</a> - Direct access full polarization raytrace. <a href = "#zGetRefresh">zGetRefresh</a> - Copies the lens in the Lens Data Editor (LDE) into the ZEMAX DDE server. <a href = "#zGetSag">zGetSag</a> - Get the sag at particular x and y coordinates on a lens surface. <a href = "#zGetSequence">zGetSequence</a> - Get the sequence numbers of the lenses in the DDE server and LDE. <a href = "#zGetSerial">zGetSerial</a> - Get the ZEMAX hardware lock serial number. <a href = "#zGetSolve">zGetSolve</a> - Get data on solves and pickups on lens surfaces. <a href = "#zGetSurfaceData">zGetSurfaceData</a> - Get a data item describing a lens surface. <a href = "#zsGetSurfaceData">zsGetSurfaceData</a> - Get data for a lens surface in a <A href = "http://www.mathworks.com">Matlab</A> structure. <a href = "#zsGetSurfaceDataVector">zsGetSurfaceDataVector</a> - Get all basic surface data in a vector of <A href = "http://www.mathworks.com">Matlab</A> structures. <a href = "#zGetSurfaceDLL">zGetSurfaceDLL</a> - Get the name of a DLL for user-defined surface types. <a href = "#zGetSurfaceParameter">zGetSurfaceParameter</a> - Get single surface parameter datum. <a href = "#zGetSurfaceParamVector">zGetSurfaceParamVector</a> - Get vector of all parameter values at a surface. <a href = "#zGetSystem">zGetSystem</a> - Get general information on the lens system in the ZEMAX DDE server. <a href = "#zsGetSystem">zsGetSystem</a> - Get general lens information in a <A href = "http://www.mathworks.com">Matlab</A> structure. <a href = "#zGetSystemAper">zGetSystemAper</a> - Get lens system aperture data. <a href = "#zGetTextFile">zGetTextFile</a> - Save text from any ZEMAX analysis window which supports text. <a href = "#zGetTimeout">zGetTimeout</a> - Get the timeout value in seconds for ZEMAX DDE calls. <a href = "#zGetTol">zGetTol</a> - Get data on a tolerance operand in the ZEMAX tolerance editor. <a href = "#zGetTolCount">zGetTolCount</a> - Get the number of current lens tolerance operands from ZEMAX. <a href = "#zGetTolMatrix">zGetTolMatrix</a> - Get a matrix of all current lens tolerances. <a href = "#zGetTrace">zGetTrace</a> - Trace a ray through the current lens in the ZEMAX DDE server. <a href = "#zGetTraceDirect">zGetTraceDirect</a> - Direct access raytrace through the current lens in the ZEMAX DDE server. <a href = "#zGetUpdate">zGetUpdate</a> - Perform update on the current lens in the ZEMAX DDE server. <a href = "#zGetVersion">zGetVersion</a> - Get the ZEMAX version which is running. <a href = "#zGetWave">zGetWave</a> - Get data on a currently defined wavelength in ZEMAX. <a href = "#zGetWaveMatrix">zGetWaveMatrix</a> - Get all data on wavelengths in a matrix. <a href = "#zImportExtraData">zImportExtraData</a> - Import extra data to a ZEMAX surface which needs it e.g. Grid Sag. <a href = "#zuiImportExtraData">zuiImportExtraData</a> - As for <a href = "#zImportExtraData">zImportExtraData</a>, but with File Open dialog box. <a href = "#zInsertSurface">zInsertSurface</a> - Insert a new surface in the lens. <a href = "#zLoadFile">zLoadFile</a> - Load a ZEMAX lens surface into the DDE server. <a href = "#zuiLoadFile">zuiLoadFile</a> - As for <a href = "#zLoadFile">zLoadFile</a>, except with File Open dialog. <a href = "#zLoadMerit">zLoadMerit</a> - Load a merit function file from a .MF or .ZMX file. <a href = "#zuiLoadMerit">zuiLoadMerit</a> - As for zLOadMerit, except that an Open File dialog is presented. <a href = "#zMakeGraphicWindow">zMakeGraphicWindow</a> - Request ZEMAX to generate a graphic display from data stored in client generated file. <a href = "#zMakeTextWindow">zMakeTextWindow</a> - Request ZEMAX to display text stored in a client generated file. <a href = "#zNewLens">zNewLens</a> - Erase the lens in the ZEMAX DDE server. <a href = "#zNumSurfs">zNumSurfs</a> - Returns the number of surfaces in the lens. <a href = "#zOpenWindow">zOpenWindow</a> - Open a ZEMAX action/analysis window. <a href = "#zOptimize">zOptimize</a> - Run the damped least squares on the lens in the ZEMAX DDE server. <a href = "#zPushLens">zPushLens</a> - Copy the lens in the ZEMAX DDE server into the ZEMAX Lens Data Editor. <a href = "#zReleaseWindow">zReleaseWindow</a> - Release a window locked during ZEMAX-client interaction. <a href = "#zSaveFile">zSaveFile</a> - Save a lens file from the ZEMAX DDE server. <a href = "#zuiSaveFile">zuiSaveFile</a> - As for zSaveLens, only a Save As dialog is used. <a href = "#zSetAperture">zSetAperture</a> - Set aperture details on a lens surface. <a href = "#zSetBuffer">zSetBuffer</a> - Write text to a buffer for ZEMAX-client interactions. <a href = "#zSetConfig">zSetConfig</a> - Change selected lens configuration. <a href = "#zSetExtra">zSetExtra</a> - Set extra data associated with a lens surface in the ZEMAX DDE server. <a href = "#zSetField">zSetField</a> - Set details of a field point in the lens. <a href = "#zSetFieldType">zSetFieldType</a> - Set the type of field points and the total number of points. <a href = "#zSetFieldMatrix">zSetFieldMatrix</a> - Set field type and all field point data from a <A href = "http://www.mathworks.com">Matlab</A> matrix. <a href = "#zSetFloat">zSetFloat</a> - Set all surface without apertures to have floating apertures. <a href = "#zSetLabel">zSetLabel</a> - Attach an integer label to a lens surface for later reference. <a href = "#zSetMEMState">zSetMEMState</a> - Set the micro-mirror state of a MEMS digital mirror device (DMD/DLP) <a href = "#zSetMulticon">zSetMulticon</a> - Set multi-configuration data for lens surfaces in ZEMAX. <a href = "#zSetMulticonOp">zSetMulticonOp</a> - Set up operand types in the ZEMAX multi-configuration editor. <a href = "#zSetNSCNull">zSetNSCNull</a> - Sets range of objects at a non-sequential surface to the 'Null Object'. <a href = "#zSetNSCObjectData">zSetNSCObjectData</a> - Set basic data for an non-sequential object in ZEMAX. <a href = "#zsSetNSCObject">zsSetNSCObject</a> - Set data for an NSC object or objects through use of a <A href = "http://www.mathworks.com">Matlab</A> structure array. <a href = "#zSetNSCPosition">zSetNSCPosition</a> - Set position and tilt of a non-sequential object in ZEMAX. <a href = "#zSetNSCParameter">zSetNSCParameter</a> - Set a parameter associated with an NSC object in ZEMAX. <a href = "#zSetNSCSettings">zSetNSCSettings</a> - Set global settings in ZEMAX related to handling of NSC ray tracing. <a href = "#zSetOperand">zSetOperand</a> - Set lens optimization operand in ZEMAX. <a href = "#zSetPolState">zSetPolState</a> - Set default polarization state for polarization raytracing in ZEMAX. <a href = "#zSetSolve">zSetSolve</a> - Set solves and pickups on lens surfaces. <a href = "#zSetSurfaceData">zSetSurfaceData</a> - Set basic lens surface data in ZEMAX. <a href = "#zSetSurfaceParameter">zSetSurfaceParameter</a> - Set a parameter associated with a lens surface in ZEMAX. <a href = "#zSetSurfaceParamVector">zSetSurfaceParamVector</a> - Set all parameters associated with a lens surface from a vector. <a href = "#zSetSurfaceParamMatrix">zSetSurfaceParamMatrix</a> - Set all parameters associated with all lens surfaces from a matrix. <a href = "#zSetSystem">zSetSystem</a> - Set global operating conditions for a lens system in ZEMAX. <a href = "#zSetSystemAper">zSetSystemAper</a> - Set aperture type and size for a lens in ZEMAX. <a href = "#zSetTimeout">zSetTimeout</a> - Set the timeout for all ZEMAX DDE function calls. <a href = "#zSetVig">zSetVig</a> - Set vignetting factors automatically in ZEMAX. <a href = "#zSetWave">zSetWave</a> - Set a wavelength and weight for the lens in ZEMAX. <a href = "#zSetWaveMatrix">zSetWaveMatrix</a> - Set all wavelengths and weights from a <A href = "http://www.mathworks.com">Matlab</A> matrix. <a href = "#zWindowMaximize">zWindowMaximize</a> - Maximize a ZEMAX window. <a href = "#zWindowMinimize">zWindowMinimize</a> - Minimize a ZEMAX window. <a href = "#zWindowRestore">zWindowRestore</a> - Restore a ZEMAX window to before a Maximize or Minimize. <a href = "#ZemaxButtons">ZemaxButtons</a> - Get a list of 3-letter codes for ZEMAX analysis and action windows (see <a href = "#zOpenWindow">zOpenWindow</a>). <a href = "#ZemaxOperands">ZemaxOperands</a> - Get a list of ZEMAX optimization operands. </PRE></P><P><A name = "ACCOSin"><H2>ACCOSin</H2></A><PRE> <a href = "#ACCOSin">ACCOSin</a> - Read an ACCOS .len file into ZEMAX. Usage : Status = <a href = "#ACCOSin">ACCOSin</a> The following return values are possible 0 : Success -1 : User Canceled operation or file not found If there are multiple .len files seperated with 'LIB PUT' commands as for a library dump, then each lens is saved as a .zmx file, and given the name in the lens idendification line of the input. In this case, <a href = "#ACCOSin">ACCOSin</a> will ask for the directory in which to store the library dump.</PRE></P><P><A name = "BIMwrite"><H2>BIMwrite</H2></A><PRE> <a href = "#BIMwrite">BIMwrite</a> - write ZEMAX format BIM file from a double image array. Usage : BIMWrite(Image, BIMfilename); Writes ZEMAX style BIM image to the given file. The .bim file extension will be appended. See Geometric Image Analysis in the Analysis Menu chapter of the ZEMAX Manual. Currently ZEMAX only supports BIM files generated from square image arrays.?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -