deb4998ba50060c48cce222fd18a8eed053918d7vboxsync/***********************************************************
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncCopyright 1987, 1998 The Open Group
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncPermission to use, copy, modify, distribute, and sell this software and its
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncdocumentation for any purpose is hereby granted without fee, provided that
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncthe above copyright notice appear in all copies and that both that
deb4998ba50060c48cce222fd18a8eed053918d7vboxsynccopyright notice and this permission notice appear in supporting
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncdocumentation.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncThe above copyright notice and this permission notice shall be included in
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncall copies or substantial portions of the Software.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncTHE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncOPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncAN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncCONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncExcept as contained in this notice, the name of The Open Group shall not be
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncused in advertising or otherwise to promote the sale, use or other dealings
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncin this Software without prior written authorization from The Open Group.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncCopyright 1987 by Digital Equipment Corporation, Maynard, Massachusetts.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync All Rights Reserved
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncPermission to use, copy, modify, and distribute this software and its
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncdocumentation for any purpose and without fee is hereby granted,
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncprovided that the above copyright notice appear in all copies and that
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncboth that copyright notice and this permission notice appear in
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncsupporting documentation, and that the name of Digital not be
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncused in advertising or publicity pertaining to distribution of the
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncsoftware without specific, written prior permission.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncDIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncDIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncWHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
deb4998ba50060c48cce222fd18a8eed053918d7vboxsyncARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync******************************************************************/
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * Machine dependent values:
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * GLYPHPADBYTES should be chosen with consideration for the space-time
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * trade-off. Padding to 0 bytes means that there is no wasted space
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * in the font bitmaps (both on disk and in memory), but that access of
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * the bitmaps will cause odd-address memory references. Padding to
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * 2 bytes would ensure even address memory references and would
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * be suitable for a 68010-class machine, but at the expense of wasted
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * space in the font bitmaps. Padding to 4 bytes would be good
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * for real 32 bit machines, etc. Be sure that you tell the font
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * compiler what kind of padding you want because its defines are
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * kept separate from this. See server/include/font.h for how
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * GLYPHPADBYTES is used.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * Along with this, you should choose an appropriate value for
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * GETLEFTBITS_ALIGNMENT, which is used in ddx/mfb/maskbits.h. This
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * constant choses what kind of memory references are guarenteed during
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * font access; either 1, 2 or 4, for byte, word or longword access,
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * respectively. For instance, if you have decided to to have
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * GLYPHPADBYTES == 4, then it is pointless for you to have a
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * GETLEFTBITS_ALIGNMENT > 1, because the padding of the fonts has already
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * guarenteed you that your fonts are longword aligned. On the other
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * hand, even if you have chosen GLYPHPADBYTES == 1 to save space, you may
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * also decide that the computing involved in aligning the pointer is more
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * costly than an odd-address access; you choose GETLEFTBITS_ALIGNMENT == 1.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * Next, choose the tuning parameters which are appropriate for your
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * hardware; these modify the behaviour of the raw frame buffer code
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * in ddx/mfb and ddx/cfb. Defining these incorrectly will not cause
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * the server to run incorrectly, but defining these correctly will
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * cause some noticeable speed improvements:
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * AVOID_MEMORY_READ - (8-bit cfb only)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * When stippling pixels on the screen (polytext and pushpixels),
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * don't read long words from the display and mask in the
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * appropriate values. Rather, perform multiple byte/short/long
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * writes as appropriate. This option uses many more instructions
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * but runs much faster when the destination is much slower than
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * the CPU and at least 1 level of write buffer is availible (2
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * is much better). Defined currently for SPARC and MIPS.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * FAST_CONSTANT_OFFSET_MODE - (cfb and mfb)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * This define is used on machines which have no auto-increment
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * addressing mode, but do have an effectively free constant-offset
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * addressing mode. Currently defined for MIPS and SPARC, even though
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * I remember the cg6 as performing better without it (cg3 definitely
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * performs better with it).
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * LARGE_INSTRUCTION_CACHE -
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * This define increases the number of times some loops are
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * unrolled. On 68020 machines (with 256 bytes of i-cache),
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * this define will slow execution down as instructions miss
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * the cache frequently. On machines with real i-caches, this
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * reduces loop overhead, causing a slight performance improvement.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * Currently defined for MIPS and SPARC
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * FAST_UNALIGNED_READS -
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * For machines with more memory bandwidth than CPU, this
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * define uses unaligned reads for 8-bit BitBLT instead of doing
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * aligned reads and combining the results with shifts and
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * logical-ors. Currently defined for 68020 and vax.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * PLENTIFUL_REGISTERS -
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * For machines with > 20 registers. Currently used for
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * unrolling the text painting code a bit more. Currently
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * defined for MIPS.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * SHARED_IDCACHE -
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * For non-Harvard RISC machines, those which share the same
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * CPU memory bus for instructions and data. This unrolls some
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * solid fill loops which are otherwise best left rolled up.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * Currently defined for SPARC.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define IMAGE_BYTE_ORDER LSBFirst /* Values for the VAX only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* vax */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# if defined(XF86MONOVGA) || defined(XF86VGA16) || defined(XF86MONO)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* __arm32__ */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define GETLEFTBITS_ALIGNMENT 1 /* PA forces longs to 4 */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync /* byte boundries */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* hpux || __hppa__ */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync/* XXX Should this be for Lynx only? */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* PowerPC */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* SuperH */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#if (defined(sun) && (defined(__sparc) || defined(sparc))) || \
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync (defined(__uxp__) && (defined(sparc) || defined(mc68000))) || \
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# if !defined(sparc)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# define IMAGE_BYTE_ORDER LSBFirst /* Values for the SUN only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# define IMAGE_BYTE_ORDER MSBFirst /* Values for the SUN only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* sun && !(i386 && SVR4) */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define IMAGE_BYTE_ORDER MSBFirst /* Values for the RISC/6000 */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* AIXV3 */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# define IMAGE_BYTE_ORDER LSBFirst /* Value for PS/2 only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# define IMAGE_BYTE_ORDER MSBFirst /* Values for the RT only*/
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync/* ibm pcc doesn't understand pragmas. */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* ibm */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#if defined (M4310) || defined(M4315) || defined(M4317) || defined(M4319) || defined(M4330)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define IMAGE_BYTE_ORDER MSBFirst /* Values for Pegasus only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* tektronix */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define IMAGE_BYTE_ORDER MSBFirst /* Values for the MacII only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync/* might want FAST_UNALIGNED_READS for frame buffers with < 1us latency */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* macII */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#if (defined(mips) || defined(__mips)) && !defined(sgi)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# define IMAGE_BYTE_ORDER LSBFirst /* Values for the PMAX only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# define IMAGE_BYTE_ORDER MSBFirst /* Values for the MIPS only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* mips */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#if defined(__alpha) || defined(__alpha__) || defined(__alphaCross)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# define IMAGE_BYTE_ORDER LSBFirst /* Values for the Alpha only */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# if defined(XF86MONOVGA) || defined(XF86VGA16) || defined(XF86MONO)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* alpha */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# if defined(XF86MONOVGA) || defined(XF86VGA16) || defined(XF86MONO)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* ia64 */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#if defined(__amd64__) || defined(amd64) || defined(__amd64)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# if defined(XF86MONOVGA) || defined(XF86VGA16) || defined(XF86MONO)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* AMD64 */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define IMAGE_BYTE_ORDER MSBFirst /* Values for the stellar only*/
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * Use SysV random number generator.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* stellar */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define IMAGE_BYTE_ORDER MSBFirst /* Values for the OMRON only*/
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* luna */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync defined(__UNIXOS2__) || \
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync defined(__OS2ELF__) || \
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync defined(__QNX__) || \
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync# if defined(XF86MONOVGA) || defined(XF86VGA16) || defined(XF86MONO)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* SVR4 / BSD / i386 */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync/* linux on the Compaq Itsy */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync/* size of buffer to use with GetImage, measured in bytes. There's obviously
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * a trade-off between the amount of stack (or whatever ALLOCATE_LOCAL gives
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * you) used and the number of times the ddx routine has to be called.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync/* pad scanline to a longword */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * This returns the number of padding units, for depth d and width w.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * For bitmaps this can be calculated with the macros above.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * Other depths require either grovelling over the formats field of the
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * screenInfo or hardwired constants.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync int padPixelsLog2; /* log 2 (pixels per pad unit) */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync int bytesPerPixel; /* only set when notPower2 is TRUE */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync/* The only portable way to get the bpp from the depth is to look it up */
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define BitsPerPixel(d) (PixmapWidthPaddingInfo[d].bitsPerPixel)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync (((int)(w) * PixmapWidthPaddingInfo[d].bytesPerPixel + \
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync ((int)((w) + PixmapWidthPaddingInfo[d].padRoundUp) >> \
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * Return the number of bytes to which a scanline of the given
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync * depth and width will be padded.
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync (PixmapWidthInPadUnits(w, d) << PixmapWidthPaddingInfo[d].padBytesLog2)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync (((int)((w) + BITMAP_SCANLINE_PAD - 1) >> LOG2_BITMAP_PAD) << LOG2_BYTES_PER_SCANLINE_PAD)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define PixmapWidthInPadUnitsProto(w, d) PixmapWidthInPadUnits(w, d)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#define PixmapBytePadProto(w, d) PixmapBytePad(w, d)
deb4998ba50060c48cce222fd18a8eed053918d7vboxsync#endif /* SERVERMD_H */