Developer Note AppleVision 1710AV and 1710 Displays Developer Press Apple Computer, Inc. 1995 This document was created with FrameMaker 4.0.
Apple Computer, Inc. 1995, Apple Computer, Inc. All rights reserved. No part of this publication may be reproduced, stored in a retrieval system, or transmitted, in any form or by any means, mechanical, electronic, photocopying, recording, or otherwise, without prior written permission of Apple Computer, Inc. Printed in the United States of America. The Apple logo is a registered trademark of Apple Computer, Inc.
Contents Figures and Tables Preface vii About This Note ix Conventions Used in This Note List of Abbreviations x Other Reference Material x For More Information xi Chapter 1 ix Overview of the AppleVision 1710AV and 1710 Displays 1 Hardware Overview 2 Operating Modes 5 Front Panel Controls 6 I/O Connections 8 Speakers and Microphone 9 Specifications 10 Macintosh Software Overview 11 Compatibility Issues 11 CPU Compatibility 12 Video Card Compatibility 12 Operating System Compatibility 13 Opportuniti
Chapter 3 Application Program Interface 25 ContrastEngine Component 27 Overview 27 ContrastEngine Component Functions 28 ContrastEngineGetBrightnessRange 28 ContrastEngineGetBrightness 28 ContrastEngineSetBrightness 28 ContrastEngineGetContrastRange 29 ContrastEngineGetContrast 29 ContrastEngineSetContrast 29 GeometryEngine Component 30 Overview 30 GeometryEngine Component Functions 31 GeometryEngineGetOverscan 31 GeometryEngineSetOverscan 31 VPTEngine Component 31 Overview 31 White Point 32 Virtual Phot
Index 45 v
vi
Figures and Tables Chapter 1 Chapter 2 Chapter 3 Overview of the AppleVision 1710AV and 1710 Displays 1 Figure 1-1 Figure 1-2 Figure 1-3 Figure 1-4 Figure 1-5 Figure 1-6 Figure 1-7 Front view of the AppleVision 1710AV Display 4 Right side and rear panel of the AppleVision 1710AV Display 4 Front view of the AppleVision 1710 Display 5 Right side and rear panel of the AppleVision 1710 Display 5 Front panel audio and video controls 7 AppleVision display I/O ports 9 Contrast and brightness panel 14 Table
viii
P R E F A C E About This Note The AppleVision 1710AV and 1710 Displays Developer Note describes design features of the AppleVision 1710AV Display, a new Apple audio/video display, and of the AppleVision 1710, a similar display with video capabilities only. This note assumes that you are familiar with the functionality of and programming requirements for Apple Macintosh computers. The note consists of three chapters, a glossary, and an index.
P R E F A C E List of Abbreviations 0 This developer note contains the following abbreviations.
P R E F A C E ■ Designing PCI Cards and Drivers for Power Macintosh Computers, # R0650LL/A, describes the Macintosh implementation of the Peripheral Component Interconnect (PCI) local bus. Chapter 11 of this book is of particular interest to developers working with AppleVision displays and the AV Architecture. Inside Macintosh is a collection of books, organized by topic, that describe the system software of Macintosh computers.
P R E F A C E For the latest specifications and information about the Display Data Channel (DDC) contact VESA 2150 North First Street, Suite #360, San Jose, CA 95131-2020 xii Telephone 408-435-0333 Fax 408-435-8225
C H A P T E R Figure 1-0 Listing 1-0 Table 1-0 1 Overview of the AppleVision 1710AV and 1710 Displays This document was created with FrameMaker 4.0.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays The AppleVision 1710AV and 1710 Displays are multiple-resolution color displays with extensive software control features. They extend the traditional display concept and provide customers with an affordable step up to a high-quality multimedia input/ output (I/O) device. The AppleVision 1710AV Display has both audio and video capabilities.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays The AppleVision 1710AV has the following additional features: ■ an output port for headphones or external speakers ■ an input port for an external microphone or other sound source ■ a built-in microphone, with PlainTalk capability and a light-emitting diode (LED) indicator ■ a built-in stereo speaker system ■ easily accessible controls to adjust sound volume, to mute sound, to adjust bass and treble, and to enable or disable th
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays Figure 1-1 Front view of the AppleVision 1710AV Display Ports for ADB and sound input Ports for ADB and sound output Bezel panel with controls Left stereo speaker Right stereo speaker Controls Figure 1-2 Right side and rear panel of the AppleVision 1710AV Display Display cable (includes display connector and ADB connector) ADB port Sound output port Video and ADB cable Power cord Sound input Sound output Video connector 4
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays Figure 1-3 Front view of the AppleVision 1710 Display ADB port ADB port Bezel panel with controls Figure 1-4 Right side and rear panel of the AppleVision 1710 Display ADB port Power input Power cord Video and ADB cable Video connector ADB connector Operating Modes 1 AppleVision displays have a feature that allows them to work in two different modes, depending on whether or not the AppleVision software is present.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays When the display is first powered up, it is in Local mode. If it is connected to a PC-compatible computer, it remains in Local mode. If it is connected to a Macintosh computer, but the Macintosh AppleVision software is not installed, it also remains in Local mode.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays Figure 1-5 Front panel audio and video controls Open AppleVision Setup or select DOS or Windows panel Select the setting Contrast control Brightness control Power Move between control rows Select one of the panel functions Sound Navigating buttons Bass volume control Treble volume control Microphone on/off Volume control Mute button There are three groups of controls on the AppleVision 1710AV Display’s front panel.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays you can select Vertical and Horizontal. The panels displayed when you select the different panels do not look the same as the panels used for the Macintosh computer. n The fourth and fifth buttons allow you to select the value for the different topics, so that you can adjust Width, Height, and so forth. If you press the + button, the value increases, and if you press the – button, the value decreases.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays computer, you will not use the ADB connector at all. To connect the display to the computer, connect the video connector to a PC adapter, and then plug the PC adapter into the PC video port. ■ There is a standard power connector that plugs into the back of the display. The AppleVision 1710AV Display also has the following sound connection: ■ The sound cable is also permanently attached to the rear panel of the display.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays ■ The headphone/speakers jack has an output level of 1.75 Vpp into a 4-ohm load, and 2 Vpp into a 10-kohm load. ■ The integral microphone is a directional microphone, optimized for use with speech recognition programs. It is particularly effective in noisy office environments.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays Table 1-3 AC power requirements (continued) Category Requirement Minimum input/output power efficiency 75%, all line conditions, maximum load Line voltage transient response ±10% instantaneous variation in average input line voltage, applied for 100 ms, with no visible effects of transient in display Load regulation Adequate for proper operation of display-related circuitry under all conditions Macintosh Software Overview 1
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays CPU Compatibility 1 Table 1-4 lists the CPUs that support the AppleVision displays. The CPUs listed have been tested in AppleVision configurations.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays Operating System Compatibility 1 You should use System 7.5 or later with the AppleVision display. If you run earlier versions of the operating system, QuickTime delays the loading of the AppleVision INIT. You may have renamed AppleVision INIT with a name that begins with a letter later than Q (QuickTime). This means that the INIT installs after QuickTime, and QuickTime moves the AppleVision components, delaying booting.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays Figure 1-7 Contrast and brightness panel Hardware Opportunities 1 Using the guidelines outlined in “New Display Connections Specifications,” third-party graphics device developers can develop plug-in video cards that offer compatibility with this new generation of displays.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays All video cards had to know the sense codes of all displays connected. Once the sense code was determined, the graphics driver trimmed its list of available timing modes to those that it calculated were possible. Before System 7.1.2, and the introduction of the Display Manager, all functional sResources not disabled by the PrimaryInit were always shown in the Monitors control panel.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays the new Display Manager. This also allows the Macintosh to display stable on-screen video early in the boot process. There is also another reason for using this sense code, as described in “Designing Display Data Channel (DDC) Displays” on page 16.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays The displays return the RGB 13” Type 6 (“straight 6”) sense code. (Refer to Macintosh New Technical Notes HW30 Sense Lines for more information.) This sense code specifies that sense line 0 is connected to ground, and that sense lines 1 and 2 are unconnected. These sense lines, therefore, may be conveniently used by DDC, subject to the following restrictions: ■ When they are powered up, the displays start in DDC1 mode.
C H A P T E R 1 Overview of the AppleVision 1710AV and 1710 Displays ■ Do not trim invalid functional sResources. If your video card does not have a programmable ROM, you will need to put the trimmed sResources back in when you patch your driver. These timing modes may be enabled by the display. ■ Trim duplicate timings. If your card has different functional sResources with the same timing, you should trim all but one of the functional sResources for each timing mode.
C H A P T E R Figure 2-0 Listing 2-0 Table 2-0 2 Hardware Interface This document was created with FrameMaker 4.0.
C H A P T E R 2 Hardware Interface This chapter describes the hardware interface for the AppleVision 1710AV and 1710 Displays. Both displays provide an interface for the video connector and the ADB ports and connector. The AppleVision 1710AV Display also provides an interface for the sound input port and the sound output port. Figure 2-1 gives an overview of the display interface.
C H A P T E R 2 Hardware Interface Figure 2-2 8 7 15 Table 2-1 Video connector pin designations 6 14 5 13 4 12 3 11 2 10 1 9 Video connector signal assignments Pin number Output signal 1 Red video ground 2 Red video 3 Not used 4 ID 1 or DDC return 5 Green video 6 Green video ground 7 ID 2 or DDC SCL 8 Not used 9 Blue video 10 ID 3 or DDC SDA 11 VSYNC return 12 VSYNC 13 Blue video ground 14 HSYNC return 15 HSYNC Shell Shield ground Abbreviations: ID DDC SCL SD
C H A P T E R 2 Hardware Interface ADB Port and Connector 2 The ADB cable is part of the dual video and ADB cable. This cable transfers ADB information between the display and the CPU, enabling you to connect ADB devices directly to the display if you wish. The ADB connector is a standard miniature DIN (MD-4) connector. It has four signal pins and an outer shield that functions as chassis ground. Figure 2-3 shows the pin designations for the ADB connector, and Table 2-2 lists the signal assignments.
C H A P T E R 2 Hardware Interface Other I/O Ports and Connectors 2 Both the AppleVision 11710AV and 1710 Display have an ADB port on both side panels.
C H A P T E R 2 Hardware Interface 24 Other I/O Ports and Connectors
C H A P T E R Figure 3-0 Listing 3-0 Table 3-0 3 Application Program Interface This document was created with FrameMaker 4.0.
C H A P T E R 3 Application Program Interface The AppleVision 1710AV and 1710 Displays use a new Macintosh framework known as the AV Architecture. This architecture allows you to access all kinds of audio and video (AV) devices, such as displays, speakers, volume controls, CD players, and so forth. The is described in detail in the AV Architecture Developer Note.
C H A P T E R 3 Application Program Interface The functions you can modify include: ■ Contrast Engine Component functions ■ Geometry Engine Component functions ■ VPT Engine Component functions To get a more complete understanding of the AppleVision API and the underlying architectural components, you should read the AV Architecture Developer Note.
C H A P T E R 3 Application Program Interface ContrastEngine Component Functions 3 This section describes the ContrastEngine Component functions that control brightness and contrast. ContrastEngineGetBrightnessRange 3 This function returns the allowable range of brightness settings for the AppleVision displays. The values returned here can be used to ensure that your application does not attempt to set an invalid brightness value.
C H A P T E R 3 Application Program Interface ContrastEngineGetContrastRange 3 This function returns the allowable range of contrast settings for the AppleVision displays. The values returned here can be used to ensure that your application does not attempt to set an invalid contrast value. pascal ComponentResult ContrastEngineGetContrastRange( ComponentInstance engineComponent, short* min, short* max ) engineComponent min, max A valid instance of the ContrastEngine component.
C H A P T E R 3 Application Program Interface GeometryEngine Component 3 This section describes those GeometryEngine component functions that can be used by the developer. It is assumed that you are already familiar with the Component Manager and, more specifically, with the AV Architecture to which the GeometryEngine component belongs. Overview 3 The GeometryEngine component, at present, provides developers with access to the overscan feature of the AppleVision displays.
C H A P T E R 3 Application Program Interface GeometryEngine Component Functions 3 This section describes the GeometryEngine Component functions used to implement overscanning. GeometryEngineGetOverscan 3 This function allows your application to determine if overscan is currently on or off. pascal ComponentResult GeometryEngineGetOverscan ( ComponentInstance engineComponent, short *overscan ) engineComponent overscan A valid instance of the GeometryEngine component.
C H A P T E R 3 Application Program Interface The colors shown on different displays may vary because of minor variances that occur during manufacture. If you are using multiple displays, you will want the colors on all displays to be as closely matched as possible. AppleVision displays have the ability to correct for manufacturing variances through a process called Virtual Photometry Technology, or VPT.
C H A P T E R 3 Application Program Interface circuitry also allows the host CPU to calculate the observed color of any pixel on the screen. Ambient Light 3 Ambient light is the light surrounding your display, and it makes a difference to the way colors appear on the screen. Ambient light may be normal window light, sunlight, incandescent light, fluorescent light, and so on. To get a true color rendering, you should first set the white point for the display and then correct for ambient light.
C H A P T E R 3 Application Program Interface CIE1976 (u’v’) 3 This data structure is used to represent the color space defined by the CIE committee in 1976. typedef struct CIE1976 { doubleuPrime; doublevPrime; doublefL; } CIE1976; uPrime, vPrime Coordinates in the standard CIE 1976 (u’v’) notation. fL Foot Lamberts, a standard unit that describes luminance. CIE1960 (uv) 3 This data structure is used to represent the color space defined by the CIE committee in 1960.
C H A P T E R 3 Application Program Interface Kelvin 3 This data type represents Kelvin degrees, a simple unit of measuring a very narrow range of colors. typedef long Kelvin; VPTGamma 3 This data structure is used by the VPTEngine component to represent a gamma table. A gamma curve defines the relationship between the color intensity (chrominance) of the screen and the light intensity (luminance) of the screen.
C H A P T E R 3 Application Program Interface VPTEngineCalibrateDisplay 3 This function allows the caller to force the display to go through a calibration cycle. Your application probably will not need to call this function, since the software included with the AppleVision display causes the display to be recalibrated automatically every two weeks or so. pascal VPTEngineResult VPTEngineCalibrateDisplay( VPTEngineComponent engineComponent engineComponent A valid instance of the VPTEngine component.
C H A P T E R 3 Application Program Interface engineComponent lastCalTime A valid instance of the VPTEngine component. The date and time of the most recent calibration. VPTEngineGetTargetWhitePoint 3 This function allows your application to determine the user-set white point for the display. The user-set white point differs from the actual white point achieved by the display’s calibration process.
C H A P T E R 3 Application Program Interface VPTEngineGetWhitePointDrive 3 This function allows your application to determine the white point drive currently being emitted from the display. This differs from the actual white point in that the white point drive does not include the effects of ambient light, even if the user has indicated that ambient light is present.
C H A P T E R 3 Application Program Interface VPTEngineGetDirectAmbientLight 3 This function allows your application to determine the amount of ambient light falling on the surface of the display. The user determines the amount of light using the Accurate Color control panel. pascal VPTEngineResult VPTEngineGetDirectAmbientLight( VPTEngineComponent engineComponent, CIE1931* directAmbientLight ) engineComponent A valid instance of the VPTEngine component.
C H A P T E R 3 Application Program Interface VPTEngineGetActualGamut 3 This function allows your application to determine the gamut the display is capable of reproducing. pascal VPTEngineResult VPTEngineGetActualGamut( VPTEngineComponent engineComponent, Tristim* red, Tristim* green, Tristim* blue ) engineComponent red green blue A valid instance of the VPTEngine component.
C H A P T E R 3 Application Program Interface Supplementary Information RGB QuickDraw colors are essentially arbitrary. It is somewhat difficult to say what actual color will be produced when a particular RGB QuickDraw color value is displayed. VPTEngineTristimToRGB 3 This function allows your application to translate a Tristimulus color value into the equivalent RGB QuickDraw value for the display.
C H A P T E R 3 Application Program Interface 42 VPTEngine Component
Glossary ambient light This is the light surrounding your display. It may be normal window light, sunlight, incandescent light, fluorescent light, and so on. The ambient light makes a difference in the way colors appear on the screen. chrominance This component of the picture information contains only the color and no picture detail. CIE (Commission International de l’Eclairage) CIE is the International Commission on Illumination.
G L O S S A RY over scan Overscan moves the screen image as close to the edges of the screen as possible without distorting the image. This setting is useful when you are using the AppleVision displays to view videos. pincushioning This term describes distortions of the screen image, where the sides of the image either bulge out to create convex pincushioning, or are pulled in to create concave pincushioning.
Index A abbreviations x Accurate Color panel 32, 38, 39 AC power specifications 10 actual white point 37 adapter for audio port 23 ADB connector 8 interface 22 pin designations 22 signal assignments 22 ADB port 9, 23 ambient light 32, 33, 37, 38, 43 APDA addresses xi AppleVision extension 13 AppleVision extensions 13 AppleVision Setup application 11, 13, 26 Application Program Interface 26 to 41 applications AppleVision Setup 11, 13 Sound & Displays 13 audio cable 9 controls 6 input 9 output 9 ports 23 audi
I N D E X D data structures CIE1931(xy) 34 CIE1960(uv) 34 CIE1976(u’v’) 34 Kelvin 35 Tristim(XYZ) 33 data types, VPTEngine Component 33 DB-15 connector 8 Display Data Channel (DDC) modes DDC1 17 DDC2B 17 sense lines serial clock (SCL) 16 serial data (SDA) 16 standards 16 Display Data Channel (DDC) standards 16 Display Manager 13, 15, 16 DOS controls 7 VPTEngineGetLastCalTime 36 VPTEngineGetReflectedAmbientLight 38 VPTEngineGetTargetWhitePoint 37 VPTEngineGetWhitePointDrive 38 VPTEngineRGBToTristim 40 VPTE
I N D E X ADB connector 22 video connector 21 International Commission on Illumination 33 I/O cable 8 connections 8 ports 9, 23 K Kelvin color temperature 43 Kelvin data structure 35 P PCI cards 16 drivers 16 PlainTalk 2 Port Components 16 ports ADB 23 audio 23 video 20 power cable 9 power on/off control 8 PowerSurge 3 PrimaryInit 15 proprietary component functions 26 L local mode 5, 6 luminance 43 Q QuickDraw 40, 41 QuickTime 13 M microphone 10 microphone on/off 8 Monitors control panel 15 MovieTalk
I N D E X speakers 9 sResources 15, 18 T tagging 16, 17, 44 target white point 37 telephony 2 text-to-speech 2 timing modes 3, 15 treble level control 8 trimming timing 15 Tristim(XYZ) data structure 33 Tristimulus color space 33 Tristimulus color value 40, 41 Type 6 Extended Sense Codes 15, 17 V vertical refresh range 3, 15 video conferencing 2 connector 8 controls 6 port 20 video card compatibility 12 video connector pin designations 21 signal assignments 21 video display 5 video driver 15 video port 2
I N D E X IN-49
T H E A P P L E P U B L I S H I N G S Y S T E M This Apple manual was written, edited, and composed on a desktop publishing system using Apple Macintosh computers and FrameMaker software. Proof pages and final pages were created on the Apple LaserWriter Select. Line art was created using Adobe Illustrator. PostScript , the page-description language for the LaserWriter, was developed by Adobe Systems Incorporated. Text type is Palatino and display type is Helvetica. Bullets are ITC Zapf Dingbats.
