PF2E Playlist
Page 1 of 2 12 Last
  1. #1
    Xarxus's Avatar
    Join Date
    Mar 2019
    Location
    Rome (Italy)
    Posts
    52

    Reference manual - problem

    Hi guys, I need your help. I am writing a Reference Manual and I have a problem immediately: the images are not shown.
    I have a client.xml file, a definition.xml and a hidden_images folder in which I am putting the images.

    I show you the code, so you tell me if I wrote something wrong (in the image I put the result: all white).
    RefManProblem.png

    I double-checked both the file name and the path and they are correct.

    client.xml
    Code:
    <?xml version="1.0" encoding="iso-8859-1"?>
    <root version="4.0">
    
    	<library>
    		<MYRULES-00>
    			<name type="string">My Rules</name>
    			<categoryname type="string">My Rules Essentials</categoryname>
    			<entries>
    				<_reference_manual_index static="true">
    					<librarylink type="windowreference">
    						<class>reference_manual</class>
    						<recordname>reference.refmanualindex</recordname>
    					</librarylink>
    					<name type="string">Reference Manual</name>
    				</_reference_manual_index>
    			</entries>
    		</MYRULES-00>
    	</library>
    
    	<hiddenimage>
    		<id-00001>
    			<image type="image">
    				<bitmap>hidden_images\Front_Cover_h780.jpg</bitmap>
    			</image>
    			<name type="string">Front Cover</name>
    		</id-00001>
    	</hiddenimage>
    
    	<reference>
    		<refmanualdata static="true">
    			<refpage_myrules>
    				<name type="string">MY RULES</name>
    				<group type="string">My Rules</group>
    				<subgroup type="string">Cover Images</subgroup>
    				<text type="formattedtext" />
    				<blocks/>
    			</refpage_myrules>
    			<refpage_frontpage>
    				<name type="string">Front Cover</name>
    				<group type="string">My Rules</group>
    				<subgroup type="string">Cover Images</subgroup>
    				<text type="formattedtext" />
    				<blocks>
    					<block_00001>
    						<align type="string">center</align>
    						<size type="string">541,700</size>
    						<image type="image">
    							<bitmap type="string">hidden_images\Front_Cover_h780.jpg</bitmap>
    						</image>
    						<caption type="string" />
    						<imagelink type="windowreference">
    							<class>imagewindow</class>
    							<recordname>hiddenimage.id-00001</recordname>
    						</imagelink>
    						<text type="formattedtext"/>
    						<blocktype type="string">image</blocktype>
    					</block_00001>
    				</blocks>
    			</refpage_frontpage>
    		</refmanualdata>
    		<refmanualindex static="true">
    			<chapters>
    				<chapter_000000>
    					<name type="string">My Rules</name>
    					<subchapters>
    						<subchapter-000001>
    							<name type="string">Cover Images</name>
    							<refpages>
    								<refpage_000001>
    									<listlink type="windowreference">
    										<name type="string">Front Cover</name>
    										<keywords type="string">front cover</keywords>
    										<class>reference_manualtextwide</class>
    										<recordname>[email protected] Rules</recordname>
    										<description>
    											<field>name</field>
    										</description>
    									</listlink>
    									<name type="string">Front Cover</name>
    								</refpage_000001>
    							</refpages>
    						</subchapter-000001>
    					</subchapters>
    				</chapter_000000>
    			</chapters>
    		</refmanualindex>
    
    	</reference>
    </root>
    Last edited by Xarxus; July 15th, 2021 at 12:01.
    FGU ULTIMATE License

  2. #2
    It's because you are defining the reference manual in an XML files with a FGU version (v4.0); but defining the type="image" values using the FGC version format (v3.x).

    The data for the reference manual must be in the same version format as the file tag. So, you either need to continue building modules in FGC and using your current reference manual method; or build in FGU but define a new reference manual creation method.

    The v4.1 format looks like this:
    Code:
    <reference>
    	...
    	<refmanualdata>
    		<refpage_frontpage>
    			<name type="string">Front Cover</name>
    			<blocks>
    				<id-00001>
    					<blocktype type="string">image</blocktype>
    					<image type="image">
    					  <layers>
    						<layer>
    						  <name>Front Cover.jpg</name>
    						  <id>0</id>
    						  <parentid>-1</parentid>
    						  <type>image</type>
    						  <bitmap>images/Front Cover.jpg</bitmap>
    						</layer>
    					  </layers>
    					</image>
    				</id-00001>
    				...
    			</blocks>
    		</refpage_frontpage>
    		...
    	</refmanualdata>
    	<refmanualindex>
    		...
    	</refmanualindex>
    	...
    </reference>
    Regards,
    JPG

  3. #3
    Xarxus's Avatar
    Join Date
    Mar 2019
    Location
    Rome (Italy)
    Posts
    52
    Oh, tnx. Perhaps I've seen the wrong pages. Have you a right link?

    Ty!
    FGU ULTIMATE License

  4. #4

    Join Date
    May 2016
    Location
    Jacksonville, FL
    Posts
    2,193
    Blog Entries
    7
    I doubt the documentation has been updated. Easiest way to get the new tags would be to import any image to your campaign, exit FG then look at the db.xml -- note that it contains a lot of tags which are not necessary just to display on a refpage. Moon Wizard's example gave all you really need for the basics.

    Another quick 'fix' is to leave your markup alone and change your version tag to:
    Code:
    <root version="3.3" release="35|CoreRPG:4.1">
    or shorten to
    Code:
    <root version="3.3">
    works in a pinch too. That will tell FGU to not look for the new imaging tags and render your refpages in Classic backward-compat mode instead.

  5. #5
    Xarxus's Avatar
    Join Date
    Mar 2019
    Location
    Rome (Italy)
    Posts
    52
    Ty Talyn!
    FGU ULTIMATE License

  6. #6
    Xarxus's Avatar
    Join Date
    Mar 2019
    Location
    Rome (Italy)
    Posts
    52
    Always talking about images and why I they are not shown, there is some change in 4.0?
    Code:
    <image type="image"><bitmap>[Only used for image blocks. Local file path to image within the module.]</bitmap></image>
    I've found here

    Even using the new version with layers I only see a white box.

    Ok, solved: I've an extension on Code which converts \ in /
    Last edited by Xarxus; July 13th, 2021 at 11:04.
    FGU ULTIMATE License

  7. #7

    Join Date
    May 2016
    Location
    Jacksonville, FL
    Posts
    2,193
    Blog Entries
    7
    Quote Originally Posted by Xarxus View Post
    Ok, solved: I've an extension on Code which converts \ in /
    Not sure what that means, but glad you've figured it out.

    Quote Originally Posted by Xarxus View Post
    I've found here
    @Moon Wizard -- far as I can tell, that particular wiki page has not been replicated on the new wiki. If you're still preferring the 'inline' method for reference manuals (I sure do, makes it way less complicated and tedious to update things) may I request that when the page does get put on the new wiki that it contains a section explaining the 'inline' method with an example?

  8. #8
    Xarxus's Avatar
    Join Date
    Mar 2019
    Location
    Rome (Italy)
    Posts
    52
    I explain myself better, I was a bit cryptic.

    I use an XML editor made by Microsoft. It's called Visual Studio Code. This editor allows you to use extensions that make programming easier. In particular I was using one for XML which, when asked to format the document (indent it correctly), replaced all the characters \ with the character /.
    This means that the path hidden_images\my_pic.jpg was changed to hidden_images/my_pic.jpg , and this was not appreciated by FGU.

    As for wikis (I don't know if you were talking to me or Moon Wizard), I always like everything. I'm struggling to find updated guides, so everything you do, everything you want to tell me, is very welcome.
    FGU ULTIMATE License

  9. #9

    Join Date
    May 2016
    Location
    Jacksonville, FL
    Posts
    2,193
    Blog Entries
    7
    Quote Originally Posted by Xarxus View Post
    It's called Visual Studio Code. This editor allows you to use extensions that make programming easier. In particular I was using one for XML which, when asked to format the document (indent it correctly), replaced all the characters \ with the character /.
    This means that the path hidden_images\my_pic.jpg was changed to hidden_images/my_pic.jpg , and this was not appreciated by FGU.
    Ah, yes I have Visual Studio Code. I'm so accustomed to Notepad++ (and a couple of the extensions for it, specifically XML Tools which I use constantly) that I have difficulty adapting myself to it, unfortunately.

    However, the / is indeed the correct character.

    Here's a sample refpage from last year (coded for Classic):
    Code:
    <refpage_00001>
    	<blocks>
    		<block_001>
    			<blocktype type="string">image</blocktype>
    			<image type="image">
    				<bitmap>images/cover.jpg</bitmap>
    			</image>
    			<imagelink type="windowreference">
    				<class>imagewindow</class>
    				<recordname>image.cover</recordname>
    			</imagelink>
    			<size type="string">535,693</size>
    		</block_001>
    	</blocks>
    	<keywords type="string"></keywords>
    	<listlink type="windowreference">
    		<class>reference_manualtextwide</class>
    		<recordname>..</recordname>
    	</listlink>
    	<name type="string">Cover</name>
    </refpage_00001>
    And here's the same refpage as I'm going through and updating for 4.1 (Unity):
    Code:
    <refpage_00001>
    	<blocks>
    		<block_001>
    			<blocktype type="string">image</blocktype>
    			<image type="image">
    				<layers>
    					<layer>
    						<name>cover.jpg</name>
    						<id>1</id>
    						<parentid>-1</parentid>
    						<type>image</type>
    						<bitmap>images/cover.jpg</bitmap>
    					</layer>
    				</layers>
    			</image>
    			<imagelink type="windowreference">
    				<class>imagewindow</class>
    				<recordname>image.cover</recordname>
    			</imagelink>
    			<size type="string">535,693</size>
    		</block_001>
    	</blocks>
    	<keywords type="string"></keywords>
    	<listlink type="windowreference">
    		<class>reference_manualtextwide</class>
    		<recordname>..</recordname>
    	</listlink>
    	<name type="string">Cover</name>
    </refpage_00001>
    This page also uses the 'inline' method mentioned above. The content and navigation info are all contained in the same place rather than having to skip around to two separate locations for each. But you'll notice they have the / character which has always been what FG expects:
    Code:
    <bitmap>images/cover.jpg</bitmap>
    Last edited by Talyn; July 13th, 2021 at 18:08.

  10. #10
    The wiki is not migrated on purpose; because we want to move away from reference manuals being generated manually. We're working on some ruleset support for reference manual building internally.

    Regards,
    JPG

Thread Information

Users Browsing this Thread

There are currently 1 users browsing this thread. (0 members and 1 guests)

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •  
DMsGuild

Log in

Log in