PowerDVD Gurus
- Skin Creation

Revision 0.1

1999 OCT.

Copyright © 1999 CyberLink Corp. All rights reserved.

Legal Information

Information in this document is subject to change without notice. Without limiting the rights under copyright, no part of this document may be reproduced, stored in or introduced into a retrieval system, or transmitted in any form or by any means (electronic, mechanical, photocopying, recording, or otherwise), or for any purpose, without the express written permission of CyberLink Corporation.

Some mechanisms described in this document are patent pending. Implementation, refer to this document and not used in CyberLink related products, must be permitted by CyberLink.

Portions of this document specify and accompany software that is still in development. Some of the information in this documentation may be inaccurate or may not be an accurate representation of the functionality of final documentation or software. CyberLink assumes no responsibility for any damages that might occur directly or indirectly from these inaccuracies.

Copyright© 1999 CyberLink Corp. All rights reserved.

The names of actual companies and products mentioned herein may be the trademarks of their respective owners.

Contents

Legal Information

Introduction

PowerDVD Skin is feature of the CyberLink PowerDVD® that provides high flexibility to enable users to create various user interface for this next generation of DVD Player. This document covers information about the skin creation you may needs to know.

A skin is consist with a skin scipt file(Skin.SKN) and several graphic files and two optional cursor files. In following sections, we'll illustrate all necessary components to create a skin.

If you would like to download more skins, please visit http://www.cyberlink.com.tw

Skin Script File

Introduction to the structure of an Skin Script File

A Skin Script file is composed of several command sections. Here is an example of a skin script file.

; This is a comment

<Information>

Name=PowerDVD Skin -- Michael No.2 (Hi-Color)

Version=2.0

Author=Your name

EMail=[e-mail]

WWW=http://www.cyberlink.com.tw

The <Information> is an information command that describe information about this skin and skin artist. Each command may have associated properties. In above example, the “Name” property represents the name this skin. White space is not permitted between the property identify and the equal delimiter (“=“).

All characters that appears after semicolon delimiter (“;”) has no special meaning.

Skin Script version information

The <Skin> command declares what version of skin script is used in the file. Current skin script version is 1.0.

<Skin>

Version=1.0

Skin Information

The <Information> command declares information about skin and skin author.

<Information>

Name=PowerDVD Skin -- Michael No.2 (Hi-Color)

Version=2.0

Author=Your name

EMail=[e-mail]

WWW=http://www.cyberlink.com.tw Graphic Files Information

The <Bitmaps> command specifies all graphic files that may use in button commands. PowerDVD current support graphic files in Windows BMP format. You may choose to use true color bitmap for better image quality, but this may introduce more memory cost while PowerDVD is running and this skin can't be correctly render under 256 color environment.

;<alias name>=<filename>[,R,G,B[,Width]]

; alias name: alias name for futher sections that reference to this bitmap

; filename: bitmap filename (.BMP format)

; R,G,B : Color-key of bitmap 0~255 (optional for transparent bitmap)

; Width : width in pixels per grid (optional for transparent bitmap)

;

<Bitmaps>

NORMAL=UI_BASE.BMP

DOWN=UI_DOWN.BMP

GRAY=UI_GRAY.BMP

VOL_BAR=VolBar.BMP,255,0,255,30

…

Cursor Information

The <Cursor> command specifies cursor files for “Select” and “Pan-Scan Drag” cursor. You can use .CUR or .ANI cursor file format. If this command does not specified cursor files, PowerDVD will use default cursor.

;

; Specify cursor files

; Syntax:

; SELECT=<filename>

; filename: .CUR|.ANI cursor file for "Select action"

;

; HAND=<filename>

; filename: .CUR|.ANI cursor file for "Pan-Scan action"

;

; Note:

; .ANI format cursor file have to separate as a individual file

; rather than as a cursor resource in .DLL

; .CUR format cursor does not have this problem

;

<Cursor>

SELECT=XXX.CUR

HAND=XXX.ANI

Panel Information

The <Panel> command specifies primary appearance of PowerDVD UI.

;

; Define Base UI Panel (required)

; Syntax:

; BMP_GRAY=<bmp alias>,left,top,right,bottom

; BMP_DOWN=<bmp alias>,left,top,right,bottom

; BMP_UP=<bmp alias>,left,top,right,bottom

; REGION=[X0,Y0,X1,Y1,…,Xn,Yn]

; optional for irrectangle Panel

;

<Panel>

BMP_GRAY=GRAY,0,0,635,91

BMP_DOWN=DOWN,0,0,635,91

BMP_UP=NORMAL,0,0,635,91

REGION=2,0,266,0,…

The <Panel_Ex> command specifies secondary appearance of PowerDVD UI. The PowerDVD change appearance between user clicked on Pad Open/Close commands.

;

; Define Secondary UI Panel (optional if no Pad Open/Close button)

; Syntax:

; BMP_GRAY=<bmp alias>,left,top,right,bottom

; BMP_DOWN=<bmp alias>,left,top,right,bottom

; BMP_UP=<bmp alias>,left,top,right,bottom

; REGION=[X0,Y0,X1,Y1,…,Xn,Yn]

; optional for irrectangle Panel

<Panel_Ex>

BMP_GRAY=GRAY,0,0,695,91

BMP_DOWN=DOWN,0,0,695,91

BMP_UP=NORMAL,0,0,695,91

REGION=2,0,266,0,…

The <Video Screen> command specifies a 720x480 pixel bitmap file that will be displayed on the video window each time PowerDVD is launched.

;

; Define video screen bitmap (required)

; Syntax:

; BMP_UP=<bmp alias>

;

<Video Screen>

BMP_UP=LOGO

The <Banner> command specifies a 20x190 pixel bitmap that will be shown in the express popup menu when user right click the mouse button. The top 20x20 region of this picture should be identical for duplicate when popup menu is growing up.

;

; define express popup menu banner

; Syntax:

; BMP_UP=<bmp alias>

;

<Banner>

BMP_UP=BANNER,0,0,20,190

Buttons Information

The button commands specifies all available buttons. For complete buttons list, please reference Appendix A.

;

; Define Button attributes

; <Button Name>

; Syntax:

; POSITION=left,top (recommend)

; BMP_GRAY=<bmp alias>,left,top,right,bottom (recommend)

; BMP_DOWN=<bmp alias>,left,top,right,bottom (recommend)

; BMP_UP=<bmp alias>,left,top,right,bottom (recommend)

; BMP_SHRINE=<bmp alias>,left,top,right,bottom (optional)

; HOTSPOT= (required)

; 2 point -> represent a rectangle : left,top,right,bottom

; 3 point+ -> represent a polygon : X0,Y0,X1,Y1, ... , Xn, Yn,

<Power>

POSITION=604,3

BMP_GRAY=GRAY,604,3,619,18

BMP_DOWN=DOWN,604,3,619,18

BMP_UP=NORMAL,604,3,619,18

BMP_SHRINE=

HOTSPOT=604,3,619,18

…

LCD Status Information

The LCD Status commands specifies all available LCD status. For complete LCD status list, please reference Appendix B

;

; Define LCD status attributes

; <LCD Status Name>

; Syntax:

; POSITION=left,top (required)

; BMP_GRAY=<bmp alias>,left,top,right,bottom (required)

; BMP_UP=<bmp alias>,left,top,right,bottom (depends)

; HOTSPOT= (recommend)

; 2 point -> represent a rectangle : left,top,right,bottom

; 3 point+ -> represent a polygon : X0,Y0,X1,Y1, ... , Xn, Yn,

; ButtonType=Ani

; MaxLevel=<total status of LCD. See Appendix B.> (required)

;

<MediaIcon>

POSITION=144,27

BMP_GRAY=GRAY,0,0,36,19

HOTSPOT=144,27,180,46

ButtonType=Ani

MaxLevel=7.

Install PowerDVD Skin

All PowerDVD skins are stored in a skin folder of PowerDVD's installed directory (C:\Program Files\CyberLink\PowerDVD\Skins). The following steps explain how to install a new skin using WinZip:

1. Copy zipped skin file to PowerDVD skin directory

1. Right clicking on zipped skin file (e.g. NEO.zip)

1. Click “Extract to folder C:\Program Files\CyberLink\PowerDVD\Skins\Neo”

You may also install skins manually:

1. Make a subfolder in PowerDVD Skins directory

1. Copy all files of skin into this directory

Submit Your Creations

Preparing your skin

1. Copy all needs files (script files, bitmap files or cursor files) of your skin in their own directory.

1. Archive the files in that directory using your favorite zip program. Here is an example using WinZip.

1. Go to the directory that contains the folder of all your skin files. (e.g. “Neo”)

1. Right clicking on folder “Neo”

1. Choose “Add to Neo.zip”

Submit skins

There is a wonderful land to share your skins with everyone around the world. Please visit: http://www.cyberlink.com.tw for further information.

Appendix A. Buttons List

Buttons	Description	Requirement
<About>	About PowerDVD	Optional
<Add Bookmark>	Add a bookmark	Optional
<Angle>	Angle change	Optional
<Audio>	Audio stream change	Optional
<Begin>	Begin/Previous	Optional
<Capture>	Capture a frame	Optional
<Config>	Configuration	Optional
<Eject>	Eject/Inject Disc	Optional
<End>	End/Next	Optional
<FastForward>	forward/backward joggle	Optional
<ForwardScan>	Forward scan	Optional
<BackwardScan>	Backward scan	Optional
<GoUp>	Go up	Optional
<Goto Bookmark>	Goto bookmark	Optional
<Help>	Invoke on-line help	Optional
<Internet>	Invoke i-Power!	Optional
<Karaoke>	Karaoke mode change	Optional
<MenuList>	Invoke PlayList/DVD Menu	Optional
<Min>	Minimize	Optional
<ModeCD>	Change to CD Mode	Optional
<ModeFile>	Change to File mode	Optional
<Mute>	Mute	Optional
<Num_0>	Number 0	Optional
<Num_10>	Plus 10	Optional
<Num_1>	Number 1	Optional
<Num_2>	Number 2	Optional
<Num_3>	Number 3	Optional
<Num_4>	Number 4	Optional
<Num_5>	Number 5	Optional
<Num_6>	Number 6	Optional
<Num_7>	Number 7	Optional
<Num_8>	Number 8	Optional
<Num_9>	Number 9	Optional
<Pad_Close>	Pad close	Optional
<Pad_Open>	Pad Open	Optional
<Pause>	Pause	Optional
<Play>	Play	Optional
<Power>	Power off	Required
<Repeat>	Repeat	Optional
<Shuffle>	Shuffle	Optional
<Slider>	Search slider	Optional
<Step>	Stepping frames	Optional
<Stop>	Stop	Optional
<Subtitle>	Change subtitles	Optional
<VolDec>	Decrease volume	Optional
<VolInc>	Increase volume	Optional
<Zoom>	Zoom Video window	Optional

Appendix B. LCD States

LCD Name	STATUS	REQUIREMENT
<MediaIcon>	Blank,CD Mode,File Mode, DVD,VCD,AudioCD,PhotoCD	Optional
<DriveIcon>	Blank, A-Z	Optional
<RegionNumber>	Blank,0-9	Optional
<AngleNumber>	Blank,0-9	Optional
<ParentalLevel>	Blank,0-9	Optional
<AudioStreamLCD>	LCID	Optional
<SubtitleStreamLCD>	LCID	Optional
<AudioMode>	Blank,Mute,Stero, Dolby,DS3D,A3D,4SPK,6SPK,S/PDIF	Optional
<PlayStatus>	Blank,Play,Pause,Still,Stop,Eject, S8,S4,S2,X1H,X2,X2H,X4,X8,FF, RS8,RS4,RS2,RW1H,RW2,RW2H,RW4,RW8,RW,	Optional
<RepeatMode>	Blank,Repeat One,Repeat All, Repeat Title,Repeat Chapter	Optional
<ShuffleMode>	Blank,Shuffle On	Optional
<Title_H>	Blank,0-9	Optional
<Title_M>	Blank,0-9	Optional
<Title_L>	Blank,0-9	Optional
<Chapter_H>	Blank,0-9	Optional
<Chapter_M>	Blank,0-9	Optional
<Chapter_L>	Blank,0-9	Optional
<Hour_M>	Blank,0-9	Optional
<Hour_L>	Blank,0-9	Optional
<Minute_M>	Blank,0-9	Optional
<Minute_L>	Blank,0-9	Optional
<Second_M>	Blank,0-9	Optional
<Second_L>	Blank,0-9	Optional
<Volume_Left>	Arbitrary level	Optional
<Volume_Right>	Arbitrary level	Optional

---