Editing XMB Manuals

=In-Game Manuals for HDD games/apps=
The manual appears with a "question mark" icon named "Software Manual" and the title_id of the game/app in small font under it, in {{icon category game}} column inside [[XMB|XMB In-Game]] mode by pressing {{padps}} button

Manuals can be used as a guide, changelog, readme, extra artwork, etc... and are loaded without having to quit the hdd app/game.

==PS3 Games==
Implemented around 4.00 firmware (not working on 3.55, working on 4.21+)

*Buttons
**{{padsquare}} to zoom in (50% zoom)/zoom out (full screen)
**{{padright}} and {{padlr}} for "next" page
**{{padleft}} and {{padll}} for "previous" page
**{{padcircle}} (or {{padcross}} for japan) returns to [[XMB|XMB In-Game]]
**{{padps}} returns to game (directly, from MANUAL back to the game, bypasing [[XMB|XMB In-Game]])

The zoom has 2 working modes, that depends of the aspect ratio of the image, there are not intermediate zoom levels, and the bigger zoom is predefined to around 50% bigger of the "full screen" mode:
*For 16:9 images
**Image is displayed initially at "full screen"
**When pressing {{padsquare}} image is zoomed-in around 50% bigger
*For non 16:9 images
**Image is displayed initially at "full height" or "full width" (bigger one wins) to keep the whole image on screen by using transparent areas all around when needed
**When pressing {{padsquare}} for first time, the image is zoomed-in to full screen, with some areas of the image out of screen
**When pressing {{padsquare}} for second time, the image is zoomed-in around 50% bigger than the previous step

===Structure tree & infos===
 '''NP**12345/MANUAL/'''001.DDS, 002.DDS    //XMB in English (United Kingdom & United States)
 '''NP**12345/MANUAL/02/'''001.DDS, 002.DDS //XMB in French
 '''NP**12345/MANUAL/03'''/001.DDS, 002.DDS //XMB in Spanish
 ...
 '''NP**12345/MANUAL/17'''/001.DDS, 002.DDS //XMB in Portuguese (Portugal & Brazil) 
 ...

*Only for PS3 type, HDD Installed Contents
*Is not supported inside PS3 game disc structure... but is supported in the "GameData" installations made by PS3 disc games and by his game updates/patches
*To add multiple manuals for different languages use the subfolders '''02''' (for french manual), '''03''' (for spanish manual), etc..., the numbers follows the system [[Content_Information_Files#Languages| Language codes]]
*Up to 999.DDS pages ? (speculative, because the image names uses 3 digits, e,g: 123.DDS but max not tested)

===Image Formats===
*The .DDS original format (found in NPUA80543) is '''DXT1C''' (dxt1, only color), '''without''' mipmaps. See: [[Multimedia Formats and Tools]]
*The resolutions (width x height) needs to have a number of pixels that is a multiple of 4 (both width and height sizes needs to be multiple of 4). DDS tools cant make a direct conversion of images that are not multiple of 4 (error: ''Image is not a multiple of 4 and no rescaling specified''), and by using rescaling is not posible to create DDS images with sizes that are not multiple of 4 (error: ''[Rescaling] [Processing] returned error IMAGE_NOT_MULT4'')


*Most useful resolutions (because all modern TV's and PS3 are designed for it) are all that matches 16:9 aspect ratio, you can see a list of the most common here: http://en.wikipedia.org/wiki/16:9#Common_resolutions
**Supported 16:9 resolutions: 640x360, 960x540, 1024x576, 1280x720, 1600x900, 1920x1080 (found in NPUA80543), 2048x1152, 2560x1440
**'''NOT''' supported 16:9 resolutions ('''not multiple of 4'''): 864x486 (486 is not multiple of 4), 1366x768 (1366 is not multiple of 4)
**'''NOT''' supported 16:9 resolutions ('''too big in bytes ?'''): 2880x1620 (2,22 MB per page), 3200x1800 (2,74 MB per page), 3840x2160 for [http://en.wikipedia.org/wiki/Graphics_display_resolution#4K_UHD 4K UHD TV] (3,95 MB per page)

{| class="wikitable"
|+Page size by resolution (comparison)
! rowspan="2" | DDS Format !! colspan="13" | 16:9 Resolutions
|-
! 640x360 !! 960x540<br>[http://en.wikipedia.org/wiki/Graphics_display_resolution#qHD (qHD TV)] !! 1024x576 !! 1280x720<br>[http://en.wikipedia.org/wiki/Graphics_display_resolution#HD (HD TV)] !! 1600x900 !! 1920x1080<br>[http://en.wikipedia.org/wiki/Graphics_display_resolution#FHD (Full HD TV)] !! 2048x1152 !! 2560x1440<br>[http://en.wikipedia.org/wiki/Graphics_display_resolution#WQHD (QHD TV)]
|-
| DXT1C,  No mipmaps || 112 KB || 253 KB || 288 KB || 450 KB || 703 KB || 0,98 MB || 1,12 MB || 1,75 MB
|}

*Other resolutions (not 16:9)
**Supported: 1280x1024

{| class="wikitable"
|+Page size by resolution (comparison)
! rowspan="2" | DDS Format !! colspan="1" | Not 16:9 Resolutions
|-
! 1280x1024
|-
| DXT1C,  No mipmaps || 640 KB
|}

{{Boxframe1|content='''Can be created with nvidia texture tool (nvdxt.exe) by using this command:'''
*Individual file:
{{Keyboard|content=nvdxt.exe -file input.png -dxt1c -nomipmap -output output.dds}}
*Individual file with cube filter rescale to 1920x1080 resolution, and highest quality compression:
{{Keyboard|content=nvdxt.exe -file input.png -dxt1c -nomipmap -prescale 1920 1080 -quality_highest -output output.dds}}
*Multiple files with cube filter rescale to 1920x1080 resolution, highest quality compression, and using folder paths for input and output (massive conversion of any supported image with any name and any resolution from CUSTOM_IMAGES folder to MANUAL folder)
{{Keyboard|content=nvdxt.exe -deep c:\CUSTOM_IMAGES -all -dxt1c -nomipmap -prescale 1920 1080 -quality_highest -outdir c:\MANUAL}}
*Nvidia Texture Tool notes:
**Supported image formats
***.tga .bmp .gif .ppm .jpg .tif .cel .dds .png .psd .rgb .bw .rgba
**DDS format and options
*** '''-dxt1c:''' DXT1 (color only)
*** '''-nomipmap:''' don't generate MIP maps
**General options
*** '''-prescale <int> <int>:''' rescale image to this size first
*** '''-quality_highest:''' highest quality compression (this can be very slow)
**Paths
*** '''-file <filename>:''' input file to process. Accepts wild cards
*** '''-output <filename>:''' filename to write to [-outfile can also be specified]
*** '''-deep <directory>:''' include all subdirectories
*** '''-all:''' all image files in current directory
*** '''-outdir <directory>:''' output directory
**Other notes
***The '''-prescale''' is a '''-rescale''' that happens first, both uses the same settings, included the default cube filter rescaling used in this examples ('''-RescaleCubic''' is the default filter used when no other filters are specifyed) and all the other availables like '''-RescaleGaussian''', etc...
}}

{{Boxframe1|content='''Can be created with gimp plugin...'''<br>
Please help to fill...
}}

{{Boxframe1|content='''Can be created with photoshop plugin...'''<br>
Please help to fill...
}}

*Pixelation notes:
Overall, and based on how the pages will be displayed with or without zoom... there are basically 2 types of manuals


The most common is the classic "user manual" from any device, where are used texts with long sentences, a few icons, and some small images overlayed to explain the working or the controlls of the device/program/game/whatever

In this kind of manual, the pages are supposed to be readed at "full screen", so is needed to use a font with good size, this makes pointless to use the zoom function (well, most users will zoom for science purposes, but they will realize is pointless because zooming in a sentence is stupid if you can read it without zoom)

For this manuals is good to go to the small resolution sizes (like 1024x576 or smaller with 288 KB per page) because there is a small pixelation but is only notable when zoomed in... and well... user is not supposed to zoom in more than 1 time (the first time for science), this manuals are good for homebrew where the manual doesnt needs to be bigger than the homebrew app itself (a manual of 30 MB for a homebrew with size 5 MB looks excesive)


The other type of manual is where it contains maps of the game with the location of items, places, or any kind of image with big detail that is interesting to display it in the bigger size posible (here the user is supposed to zoom in allways in every page)

For this ones is good to go for the bigger resolution sizes like 2560x1440 (and 1,75 MB per page) because usually there are not much pages and are for games wich size is much bigger than the manual (a manual of 100 MB for a game with size 10GB doesnt looks excesive)

===Links & Tutorials===

*[http://rghost.net/48647164 Here is a example of MANUAL] in game, for PS Seismograph [http://store.brewology.com/get/homebrew.php?id=177&fid=963 all] / [http://store.brewology.com/get/homebrew.php?id=177&fid=964 unsigned] (7 pages not official version). 
*[http://www.ps3hax.net/showthread.php?p=668763 here is a example of MANUAL] in game, for FB Alpha Retro Loader by '''CaptainCPS-X''' (24 pages).
*[https://github.com/CaptainCPS/FBAlphaRL/commit/d876617722270acf9161afd83e6cd73014210dc5 git of CaptainCPS-X with infos for pkg.py to create propers pkg including MANUAL]
*[http://psx-scene.com/forums/content/retroxmb-icon1-pam-manuals-dds-redemp-4365 retroXMB MANUAL] by '''Redemp'''
*[https://anonfiles.com/file/942ee38bcf72321b05a11c76233b768b True Ancestor PKG Creator patched for MANUAL]
*[http://psx-scene.com/forums/content/redemp-s-xmb-video-icon-icon1-pam-dds-manuals-collection-retroxmb-4550/ PSX SCENE thread resource by '''Redemp''']

===Gallery===
Note: images has been converted to jpg for wikify purpose.
<GALLERY>
File:PS_Seismograph_page002.jpg | PS Seismograph page 002
File:PS_Seismograph_page003.jpg | PS Seismograph page 003
File:PS_Seismograph_page004.jpg | PS Seismograph page 004
File:MANUAL_FB_Alpha_Retro_Loader_001.jpg | FBAlphaRL page 001
File:MANUAL_FB_Alpha_Retro_Loader_003.jpg | FBAlphaRL page 003
File:MANUAL_FB_Alpha_Retro_Loader_017.jpg | FBAlphaRL page 017
</GALLERY>

==PS2 Classics==
*0xx.dxt files: [[Multimedia Formats and Tools|textures files]]
*manual.idx: index of the .dxt files

==PS1 Classics==

==PSP Minis and Remasters==

=Standalone Manuals=
==PS3 PlayView==
See [[PlayView|PlayView]] for other PS3 standalone digital manual

==PSP Digital Comic==
[[Talk:Eboot.PBP#Misc:_Digital_Comic_PSP|Digital Comic for PSP]]

==PS3 DigiManual==
Named as Digimanual or Manual (Digital), they are stand alone pkg PS3 hdd games included in disc (PKGDIR for example) or available online.

Seems to be a standard utility (the eboot) specific to display this kind of manuals, so should be considered an app, not a feature of the firmware

===Structure tree===

<div style="height:300px; overflow:auto">
 NPUO30***/ (only from few US example)
     |
     |-ICON0.PNG (See[[Content_Information_Files#HDD_Game| Content Information files for HDD Game]])
     |
     |-PARAM.SFO (SFO category HG)
     |
     |-PS3LOGO.DAT
     |
     |-USRDIR/
           |
           |-digiman.sdat
           |
           |-digiman_content.sdat
           |
           |-digiman_content_en.sdat (can also have others languages as digiman_content_es.sdat..)
           |
           |-EBOOT.BIN
           |
           |-assets/
                 |
                 |-image/ (can contain sub-directory such "screenshots", "modals"...)
                 |    |
                 |    |-.jpg and .png
                 |
                 |-sound/
                 |    |
                 |    |-.wav
                 |    
                 |-video/
                      |
                      |-.usm
</div>

=Web Manuals=
==Online Manuals==
Online instruction Manuals on [[XMB-Network|XMB Network column.]] accesses the manuals hosted at (click in the table below to go to a specific manual page):

{| class="wikitable" style="margin:auto"
|+ Read [http://manuals.playstation.net/document/en/ps3/current/ manuals.playstation.net/document] and [http://us.playstation.com/support/manuals/ps3/index.htm us.playstation.com/support/manuals]
! {{icon category users}}<BR />[http://manuals.playstation.net/document/en/ps3/current/users/index.html Users] !! {{icon category settings}}<BR />[http://manuals.playstation.net/document/en/ps3/current/settings/index.html Settings] !! {{icon category photo}}<BR />[http://manuals.playstation.net/document/en/ps3/current/photo/index.html Photo] !! {{icon category music}}<BR />[http://manuals.playstation.net/document/en/ps3/current/music/index.html Music] !! {{icon category video}}<BR />[http://manuals.playstation.net/document/en/ps3/current/video/index.html Video] !! {{icon category tv}}<BR />[http://manuals.playstation.net/document/en/ps3/current/tv/tvvideoservices.html TV/Video Services] !! {{icon category game}}<BR />[http://manuals.playstation.net/document/en/ps3/current/game/index.html Game] !! {{icon category network}}<BR />[http://manuals.playstation.net/document/en/ps3/current/network/index.html Network] !! {{icon category psn}}<BR />[http://manuals.playstation.net/document/en/ps3/current/psn/index.html PlayStation Network] !! {{icon category friends}}<BR />[http://manuals.playstation.net/document/en/ps3/current/friends/index.html Friends]
|-
|}

==Game Options Menu Manuals==
Some games has an online manual that can be accessed from the "options menu" in main XMB (by pressing triangle over the game icon)

=Manuals Multilingual Support=
{{XMB languages}}
*Notes:
**Portugues (Portugal), and Portugues (Brazil) can share the same manual ingame
**English (United States), and English (United Kingdom) can share the same manual ingame

{{File Formats}}<noinclude>[[Category:Main]]</noinclude>