Related
[UC]XDA_UC V2.RC1, Automated & Silent User & Cook, Configuration Service[14/05/10]
V2.RC1 Update,... New AutoShortcut Commands, new SDConfig.txt Commands, Manual and Storage Card install folders added, Extra parameters for Cooks.
I'll be updating all documentation accordingly later today.
Another (The?) new way to implement User Customization and Cooking.
This Thread is meant for Rom Cooks.
Users should take a look at the User To User Tips, Tricks ideas and issues thread.
What the XDA UC service does, is silently install (or not so silently if needed by User), .cab, .xdas, .xml, .reg, .mscr, copy over user manila files, install files from SDconfig.txt if wanted and then a few extra's for the freaks like copying folders or creating shortcuts from specific registries. This happens either at first or second boot depending on the existence of either RunCC.exe or Autorun.exe in rom.
It's all Mortcsript so it's very easy to get a grasp of it and change the behaviour and or Chip in adjustments/improvements.
But no knowledge of mortscript is needed to implement
It Uses DotFred's Taskmanager to parse and implement the .reg and .xml files. But it can also be used to disable or enable services or register DLL files.
More Information about the XDA Type Files at:
http://wiki.xda-developers.com/index...ename=XDA_file
My Shout out for this Two Year Long Evolving Collaborating Endeavour go to:
Bengalih (that has a very similar UC variant called Sashimi and helped with some of the early scripts I was trying to do with mort while cooking, I wish I could have collaborated more with him, it would have saved time re-inventing the wheel), RoryB for bouncing back ideas, supplying new scripts and perfecting older ones, serfer222 For making the script compacter, jmckeejr, Ameet & the whole Digital XDA SPC Cooking Crew, bbobeckyj, CLHatch, Scinor, Mort, Sleuth255, McCune, DotFred, MrVanx, danny_and_2, Cmonex, utak3r, Laurentius26, Radimus, and the Whole Original SPC Crew for accepting my obsessions.
For Knowingly helping me get the information, unknowingly helping me get the information or motivated me in keep going on in my Quest resulting in this.
If I Forgot you, Forgive me.
If you feel that certain information that has been used originated by you give me a holler and I will credit you if this is so.
Before you consider buying me a beer. Please consider Donating to XDA to help out with the maintenance of the forum and get cool stars next to your Nickname showing your appreciation. Then there are always the people that without their apps this wouldn't have been possible at all that you can consider showing some love. Mort, DotFred & Sleuth255 All of whom made Apps Seemingly simple But oh so useful for the whole XDA and PocketPC community.
Download and Info in next Post
What this version of the XDA UC service does, is silently install and execute (listed in the order the items get installed)
Run the Users customisations of course.
User side information here...
Run Cook.mscr in Windows folder(For Cooks Only)
More Cook info coming.
Add native support for .mscr, .mortrun, .xda, xdai, xdas & .xdaz files
(Where in "\Storage Card\" is read from HKLM\System\StorageManager\Profiles\SDMemory For MultiLanguage Support)
Requirements
The Rom should have the security relaxed in HKLM\Security\Policies\Polices by setting the value 0000101a to a 1.
So unsigned installations and Mortscript do not give a security error.
If you have a different language then English, don't forget to change the path in the initflashfiles.txt/app.dat file (if your using legacy kitchen )
The rest of the script should dynamcliy get the correct variable for the storage location.
In the end the process it comes down to the device starting after flashing and not needing any reboot while silently installing Cook and User configurations.
On the User end and cook end no SDConfig.txt ort config.txt file is needed.
Attached the OEM Package and a Sample Package for SD.
(Klaxon.Cab, GoogleMaps.xdas, two .reg files, two xml files, my.tsk, and a test mortscript)
The Control factors of the Sample SD Package is that is should install
HKLM\Software\XDA\Test\Reg 1 Parsed=1
HKLM\Software\XDA\Test\Reg 2 Parsed=1
HKLM\Software\XDA\Test\xml1parsed=1
HKLM\Software\XDA\Test\xml2parsed=1
These are the tweaks present in those files.
In addition everything installed will be found under
HKLM\Software\XDA\UC\
And the Morscript in the sample SD Card Package should give a message to confirm it was executed "Mort UC From SD Working"
Cab Files and XDAS files should eventually just be in the startMenu Programs.
G-Alarm is there because it needs User interaction and that will pop up when it needs your attention.
At the end of it all you get a message Installations have finished.
When using SDConfig.txt be sure to add a blank line at the end of it.
Disclaimer:
Please be aware that the XDA_UC script contains a disclaimer, not to post errors with it to the Mortscript forums, and the usual this **** cloud be dangerous to your phones health.
For Standalone version, place XDA_UC folder from "User_Storage Card" on Storage Card.
Then run "\Storage Card\XDA_UC\Install\XDA_UC.exe"
Information about the SDAutorun.exe V2 UC can be found here:
http://forum.xda-developers.com/showthread.php?t=366337
Information about SDConfig.txt & .xml user setup can be found here:
http://forum.xda-developers.com/showthread.php?p=5011285
Changelog:
V 1.0.01
Changed Sleep to start UC to 50 seconds for full device Boot before UC starts.
Changed "XDA UC Service Start" title to "customization" to match the old one.
Changed sleep before completion message to ten second in case the last cab needs user input and the Completion message pops up to early.
Changed Sleep at while for Theme installation to 2 seconds.
V 1.0.02:
Added Copy1 to Copy2 by reading from registry settings
[HKLM\Software\XDA\DirCopy]
"\\Storage Card\\Some Folder"="\\My Documents\\Some Folder"
Added Disabling Manila from Homescreen then Copying files from "\Storage Card\XDA_UC\manila" to Windows, The checking for existence of wallpaper_TF3D.png or wallpaper_TF3D.jpg and adding that to
[HKCU\Software\HTC\Manila]
"HomeBackgroundPath"="\\Windows\\wallpaper_TF3 D.jp g"
Import registry files from "\Storage Card\XDA_UC\manila\manila.reg"
Re-enable Manila on Homescreen and redraw it.
If not present do nothing.
Added RoryB's Complete SDAutorun.exe replacement/SDConfig.txt parser script.
Check for existence of Autorun.exe or RunCC.exe to automatic determine which method/bootcount to use.
There is no longer the need for two separate XDA_UC versions let alone a third.
.reg and .xml files will no be sent to renamed taskmanager "FS_TaskMgr.exe"
Added checking for cab files in "\Storage Card\XDA_UC\SD\", for those that don't have the luxury of changing the install paths in a cab file to hardcode these to Storage Card. So you get full user input to choose on these cabs.
V 1.0.03:
Todo's
Add Support For Diamond Internal Storage Need Someone with a Diamond to Test.
V 1.0.04:
Added Support for PimPackup files *.pib & .cer files.
Moved Disclaimer to the beginning and added an option to reset ad the end.
V 1.1.00:
Added extra Runs for Diamond and Samsung Internal Storage.
V 1.1.1B2:
Applied script improvements to reduce code used and make script a bit faster.
Removed Manila folder copy and replaced it with more general Copy2Root function/folder.
Added recognition of "REG: " command in SDConfig.txt parsing.
Added recognition of "CER: " command in SDConfig.txt parsing.
Testing:
Code:
If( FileExists( "\" & SDF & "\Cabs\pim.vol" ))
Kill("cprog.exe")
EndIf
During SDConfig.txt just before cpy1, cpy2 function.
V 1.1.1B3:
Mayor overhaul by new script from Serfer222
And then I started adding more crap and messing the new clean code up.
XCP1 & XCP2 commands for SDConfig.txt (Folder Copy with SDConfig.txt)
MCAB command for SDConfig.txt (Cabs that you want manual input for during SDConfig.txt)
SCAB command for SDConfig.txt (Cabs that you want installed to SD SemiAutomaticly during SDConfig.txt)
SC1 & SC2 commands for SDConfig.txt (Shortcut creation with SDConfig.txt)
KILL command for SDConfig.txt (Kill a running .exe/process)
EXEC: command for SDConfig.txt (Was already present but i removed the checking if the file is a .exe so anything can be executed and)
Del: Command for SDConfig.txt
.PROVXML now also get parsed in XDA_UC folder
Changed Serfer222's fix to parse mail xml files before PimBackup to "*mail*.*xml" so now if there's a file containing mail anywhere or is a .provxml get's parsed before PimBackUp.
RESET command for SDConfig.txt
WR1: & WR2: commands to write files using SDConfig.txt
Parse File containing "WiFi in it's name" Early like MyHomeWiFi.xml or MyHomeWiFi.provxml
Add a script to run and add XDA_UC to rom's without it.
"Manual" Folder in XDA_UC folder for Full Manual .cab Installs
"Storage Folder in XDA_UC folder for Semi Silent .cab installs to Storage
Early "*wifi*.*xml" parsing from XDA_UC for quick Wifi connecting.
Eauh maybe i forgot some stuff....
Bug Tracker for last Beta.
Wrong code for the WR1: & WR2: commands (Updated Beta Download with Fixed Script)
WR1: command needs a delete or else the next time it is run it will add text to the file instead of write a new one. Working on Fix. Fix Updated in original Download.
Changed XCP1: XCP2: commands into MOV1: & MOV2: to avoid confusion with CPY1: & CPY2: (TNX RoryB good one) Updated in original Beta Download.
Other Updates I'm looking into All Beta:
Changed Manila/Sense Script so it now Checks for manila.reg @ "\Storage Location\XDA_UC\Copy2Root\Windows\manila.reg" and runs the reg from there.
Test everything again
More optimisation of the code suggested by Serfer222
Call for Sashimi & PresetInstaller, so having Making an XDA UC Rom doesn't force users switching their preferred UC Setup.
Add DELT: command
Config.txt for Cooks (May not be included as it is partly redundant)
SDAutorun replacement without SDAutorun.exe
Information will be added about this in the future.
Some more changes to my method I thought I would share.
Run the items in SDConfig.txt without using SDAutorun. I do not have any tsk to run, but it would work the same. I put copy first since some EXECs like xcopy need to be copied before execution.
Code:
###############################
# SDConfig without SDAutoRun
###############################
; Wait 10 seconds to start to be sure SDCard can be accessed
Sleep( 10000 )
If( FileExists( "\Storage Card\SDConfig.txt" ))
xcount = ReadLine( "\Storage Card\SDConfig.txt" )
While( IsEmpty( xcount ) = FALSE )
If( SubStr( xcount, 1, 5 ) eq "CPY1:" )
xcopy1 = SubStr( xcount, 6 )
xcount = ReadLine( "\Storage Card\SDConfig.txt" )
If( SubStr( xcount, 1, 5 ) eq "CPY2:" )
xcopy2 = SubStr( xcount, 6 )
Copy( xcopy1, xcopy2, TRUE )
EndIf
ElseIf( SubStr( xcount, 1, 5 ) eq "CAB: " )
RunWait( "\windows\wceload.exe", "/nodelete /silent " & [COLOR=blue]"""" & [/COLOR]SubStr( xcount, 6 ) [COLOR=blue]& """" [/COLOR])
While( ProcExists ( "wceload.exe" ))
sleep( 3000 )
endwhile
Else[COLOR=red]if[/COLOR]( SubStr( xcount, 1, 5 ) eq "EXEC:" )
If( SubStr( xcount, -[COLOR=red]3[/COLOR] ) [COLOR=red]eq[/COLOR] [COLOR=black]"[/COLOR][COLOR=red]exe[/COLOR][COLOR=black]"[/COLOR] )
Run( SubStr( xcount, 6 ))
EndIf
[COLOR=red] ElseIf( SubStr( xcount, 1, 5 ) eq "XML: " )[/COLOR]
[COLOR=red] RunWait( "\windows\TaskMgr.exe", "/provxml " & SubStr( xcount, 6 ))[/COLOR]
[COLOR=red] While( ProcExists ( "TaskMgr.exe" ))[/COLOR]
[COLOR=red] sleep( 3000 )[/COLOR]
[COLOR=red] endwhile[/COLOR]
[COLOR=red] ElseIf( SubStr( xcount, 1, 5 ) eq "TSK: " )[/COLOR]
[COLOR=red] RunWait( "\windows\cusTSK.exe", SubStr( xcount, 6 ))[/COLOR]
[COLOR=red] While( ProcExists ( "cusTSK.exe" ))[/COLOR]
[COLOR=red] sleep( 3000 )[/COLOR]
[COLOR=red] endwhile[/COLOR]
[COLOR=red]Else[/COLOR]
EndIf
xcount = ReadLine( "\Storage Card\SDConfig.txt" )
EndWhile
EndIf
I have a mortscript I call user_C.mscr for some customizations that I used EXEC to run, but thought this way people could have multiple scripts.
Code:
If( DirExists( "\Storage Card\SDAUTO" ))
ForEach xscriptfile in Files( "\Storage Card\SDAUTO\*.mscr" )
CallScript( xscriptfile )
sleep( 3000 )
EndForEach
EndIf
Lastly, I have this final folder to hold cab files I want to install with user input. It also has a script to cleanup a few things from the cab install.
Code:
If( DirExists( "\Storage Card\SDAUTO\Final Files" ))
ForEach xcabfile in Files( "\Storage Card\SDAUTO\Final Files\*.cab" )
Runwait( "\Windows\wceload.exe", "/nodelete " & [COLOR=blue]"""" & [/COLOR]xcabfile [COLOR=blue]& """"[/COLOR] )
While( ProcExists ( "wceload.exe" ))
sleep( 3000 )
endwhile
EndForEach
ForEach xscriptfile in Files( "\Storage Card\SDAUTO\Final Files\*.mscr" )
CallScript( xscriptfile )
sleep( 3000 )
EndForEach
EndIf
I had to set config.txt to hide the overlay image and not lock the screen to allow seeing the messages and responding to them. Eventually I see this changing to have the first script copied to start up folder by an initflashfile and not even need AutoRun. Currently config.txt starts the mortscript and does nothing else.
Cook.mscr
If your cooking and want your own mortscript to also be run at first boot just name it cook.mscr and put it into Windows folder.
Update: From Version 1.2.0 Cook.mscr will be executed at the same moment as the rest of XDA_UC, so this is depended on if RunCC or Autorun is used.
Suggestion:
install the cabs in a known order, perhaps alphabetically, so that we can name the files in the order to install like so
10_MSVC.CAB
20_PIMBackup.Cab
etc means we can control the install order.
Reason I chose not to use the known "Cabs" folder is not to screw with that configuration.
(XDA_UC is backwards compatible with SDAutorun v2 SDConfig.txt)
Cabs will be automatically be parsed alphabetically that's a default when more cab's are being processed.
At least I think so
It's using MortScripts ForEach File command.
Almost Everything processed will be written to registry under.
HKLM\Software\XDA\UC
And no more hassle with cabs that need user interaction.
You just interact when they come up.
If it's a good idea I could also make it check for a present Welcomehead.png or the Existence of a TF3D folder to copy over personal TF3D files.
Uploaded the OEM and a Sample SD Test Package.
is there a way this could be done without removing the RUNCC?
Yes there is.
There's a few different solutions.
I have added your request to the first Posts.
It runs at second boot and skips a few things that RunCC takes care of like installing cabs present in the windows folder.
This way you can keep everything is with RunCC and the welcome.lnk in initflashfiles.dat
Personally I prefer the First method with no reboots at all but it does require some extra meddling in the Rom.
Hello,
I have some questions...
Noonski said:
(This Method is under Review as it seems the latest RunCC accepts config.txt files from SD)
Click to expand...
Click to collapse
Noonski said:
This didn't work in earlier versions i had my hands on.
Click to expand...
Click to collapse
Which version is this? 1.0.9.0?
RunCC can execute the same commands in config.txt? (EXEC, TSK, XML, CAB...)
I have yet to get a hold of the version l3v5y's using.
Yes RunCC can but it needs configuration. Now for a cook that isn't any problem. But for Simple users all they need to do is drop some cabs and tweaks they have collected throughout the forum into a folder not be annoyed by.
I posted a rom already that has runcc installing from sdcard's config.txt. Not too difficult at all, wonder why more cooks don't figure it out.
Because Earlier releases of RunCC from leaked roms did not except these commands.
I have just extracted a version of it from an official Rom and it's got the same version i was using before 1_0_9_0
So weird that it is now accepting it.
But looking back i did not use the addrun("RunExtra"
I did try the Run customer, and default tho.
(Slaps in his forehead)
But it's still not the same as i'm trying to offer here.
Noonski said:
Because Earlier release of RunCC from leaked roms did not except these commands.
I have just extracted a version of it from an official Rom and it's got the same version i was using before 1_0_9_0
Click to expand...
Click to collapse
Noonski said:
So weird that it is now accepting it.
But looking back i did not use the addrun("RunExtra"
I did try the Run customer, and default tho.
(Slaps in his forehead)
But it's still not the same as i'm trying to offer here.
Click to expand...
Click to collapse
What you're trying to offer here is IMHO a far better solution!
Sorry for not getting you my tweaked package, though you seem to have managed without...
I think having a complete solution, with automated install of all cabs in a folder would be great.
Well i also needed to Scour the new Roms for some updated OEMS and i needed to know for sure that welcomehead.192.png was named that way to add it to the process.
And maybe even a Copy User Preferred Manilla files from SD to device if present. There must be some other good ideas from people that like flashing, but are tired of installing their preferred skins, settings and Apps.
Unfortunately i found that the newer package of Connectionsetup asks for a reset where my previous VGA reskinned package did not.
All the Regs are te same (Except for two new unrelated ones).
I like the old non rebooting version better.
I know that a reboot isn't needed but i can see users unkowingly agree to that reboot. (But that's another subject)
I think i will change the package this weekend So it is only one method.
By default it is set to run at second boot, but it can easily be changed by the cook to run at first boot if that is the setup that one would prefer.
Also i'm still tinkering out the exact form of the XDA files.
But nice to hear i'm not on an island, l3v5y.
Noonski said:
Well i also needed to Scour the new Roms for some updated OEMS and i needed to know for sure that welcomehead.192.png was named that way to add it to the process.
And maybe even a Copy User Preferred Manilla files from SD to device if present. There must be some other good ideas from people that like flashing, but are tired of installing their preferred skins, settings and Apps.
Click to expand...
Click to collapse
Noonski said:
Unfortunately i found that the newer package of Connectionsetup asks for a reset where my previous VGA reskinned package did not.
All the Regs are te same (Except for two new unrelated ones).
I like the old non rebooting version better.
I know that a reboot isn't needed but i can see users unkowingly agree to that reboot. (But that's another subject)
I think i will change the package this weekend So it is only one method.
By default it is set to run at second boot, but it can easily be changed by the cook to run at first boot if that is the setup that one would prefer.
Also i'm still tinkering out the exact form of the XDA files.
But nice to hear i'm not on an island, l3v5y.
Click to expand...
Click to collapse
I think the "EXEC:" command waits for the process to close? If yes, then an application that runs some mortscripts could wait till all the mortscripts are run before continuing, so it can be run at first boot within RunCC. That saves the issue of an extra reboot...
Welcomehead.192.png is the file for VGA/WVGA devices, welcomehead.96.png is for QVGA devices, though it's actually set in the registry, so that could be checked at load time? (I'll find the registry key at some point...)
Something I've just thought of:
If there were a way for ROM cooks to block things that are known not to function or are included already, that would be quite useful. E.G. I include PIMBackup in ROMs, so why would anyone install an extra cab to do the same?
You could add a check for a specific .Cab name.
And if present change the extension.
Repeat and Rinse a few times.
Then at the end rename all .cabxx back to .cab
I think in general, not a lot of people change their cab names.
Unless like that previous post, someone likes to add numbers to them to control the order.
But in this Silent install method i can see that having one app being installed first could be useful as there's small pauses build into the script so the device isn't slow as hell the first minutes it boots.
I think it might get more error prone if it gets executed through RunCC.
With all the processes that get proccesed through the script.
It's using and starting, cusTSK.exe, TaskMgr.exe, wceload.exe and mortscript. But when Mortscript exitst it should be finished.
I would need to test this style to feel confident it doesn't reboot while there's still work in progress.
I Agree that getting it into the No Reboot style might be some extra work for cooks. And maybe i'm seeing this to much from my own perspective where i always remove and convert OEM configurations to straight forward packages.
Noonski said:
You could add a check for a specific .Cab name.
And if present change the extension.
Repeat and Rinse a few times.
Then at the end rename all .cabxx back to .cab
Click to expand...
Click to collapse
Noonski said:
I think in general, not a lot of people change their cab names.
Unless like that previous post, someone likes to add numbers to them to control the order.
But in this Silent install method i can see that having one app being installed first could be useful as there's small pauses build into the script so the device isn't slow as hell the first minutes it boots.
I think it might get more error prone if it gets executed through RunCC.
With all the processes that get proccesed through the script.
It's using and starting, cusTSK.exe, TaskMgr.exe, wceload.exe and mortscript. But when Mortscript exitst it should be finished.
I would need to test this style to feel confident it doesn't reboot while there's still work in progress.
I Agree that getting it into the No Reboot style might be some extra work for cooks. And maybe i'm seeing this to much from my own perspective where i always remove and convert OEM configurations to straight forward packages.
Click to expand...
Click to collapse
I personally hate having cabs installed, so in theory my ROMs should be good to go without the reset.
Based on what you said, it might be best if the number of complications are minimal, and device compatibility as great as possible. RunCC probably would make things more complex and error prone, so yes, I agree not having it as a dependency makes sense.
A mortscript could always recognise *cabname.cab, so even using an order flag at the front should work.
Silent install sounds like it could be great, although some of the cabs need user intervention... Also, having a flag settable somewhere that makes (or stops) a message box with "auto install is complete" would be useful...
At the moment i have G-Alarm in my SD folder for that User intervention.
It just pops up at the moment after it's install i know at first i waited for it, no i grab a beer and tap it when i arive but the script continues with the rest of the files present so it's not waiting on that user interaction.
The possible Pop up message would in theory come up at the moment the last cab is just starting to install but it should be possible to add a check if wceload is still active before it pops up.
Which reminds me i still need to contact some of the people that actually helped out a lot without knowing.
"Installation has Finished, if your in a good mood and were planning to get beer from the fridge choose yes to reset the device, If your not in the mood and need to actually use your phone right now, press no to reset whenever you feel like it"
Do you think that would fit in the screen
Are you interested in making or editing a CHT widget? To make a widget for Co0kie Home Tab 2.0.0 is not such a difficult job as you may think, I tell you by experience. I have no previous formation in programs or informatic code but i could make a few widgets(*) and I would like to share this experience with you. This is not so altruistic work, I am expecting a huge amount of widgets made by all of you to install and enjoy in my brand-repaired HD2
Co0kie Master has allready published a guide for making a CHT widget (it is into the widgets kitchen); also Genius_Rat_2665 has made a tutorial for making a cht clock widget, so -the third time lucky- lets bring here all that knowledge and try to make a simple widget step-by-step. Also this could be a good place to share and learn each other some code for widgets. Things like how to make an blinking element, how to change number in text, how to read from the registry, etc.
(*) What is for sure is that no one widget I could ever do without the help of others. Lets start quoting the existing Co0kie's guide:
Here is a guide on how to build your own widget for CHT.
I decided to break this up into 3 parts.
The kitchen section is a brief description of the kitchen structure and batch files.
The guide section will tell you how to build your own widget and make a cab to install it.
The "how it works" section will tell you what's going on in the background - why the system is the way it is.
#####################
*** 1) Kitchen ******
#####################
Just a few words about the kitchen folder structure:
- Workspace - here you'll find all the raw files that are being worked on currently
- Tools - all the needed tools
- deploy - just a little temp dir used by the batch scripts to compile and deploy files directly to your device
- cab - the cab file and setup.dll
- cab\_files_final - all the final compiled files that will need to be inside the cab
The batch files:
These files automate the process of editing manila files.
Connect your device to your PC via ActiveSync to be able to run the batches.
z_init.bat - You need to run this one before starting. You just need to run it one time. It will copy restartmanila.exe to you device.
_Deploy_to_device_in_dev_mode.bat - this batch will:
1) compile the lua files from \workspace\_lua and copy them to the deploy folder
2) copy all files from \workspace\mode9 and other \workspace\ subfolders to the deploy folder
3) use rapicopy.exe to copy everything from the deploy folder to \windows on your device (it's set to overwrite exitsting files)
4) restart manila on your device
_Generate_files_for_cab.bat - this will compile and copy the workspace files but it will not deploy them to your device,
instead it will copy them to \cab\_final_files
it will also rename the base mode9 and lua files to CHTmode9 and CHTlua - more on this in the "how it works" section
[[ It also needs to be modified the files _Generate_files_for_cab.bat & _Deploy_to_device_in_dev_mode.bat to addapt them to your own widget. Click with the right button of the mouse over the files and select edit, then change the name of the widget (PoyTEST.lua & PoyTESTtranslation.lua in the attached example) and the corresponding manila files ]]
[[ Tools folder includes m9editor for the edition of mode9 files, notepad2 for the edition of the Lua files, CFC_GUI for the qtc files (graphics), manilaHASH to obtain the right manila names corresponding to .luac files, and some other .exe files used automatically by the kitchen. ]]
################################
*** 2) Making your widget ******
################################
Guide - how to make CHT addon widgets:
First of all, because you will be developing, you need to turn on CHT's dev mode.
Open the reg key HKCU\Software\HTC\Manila\ and create a DWORD value, call it "CHTI.AddonWidgets.DevMode" and set it to 1.
This will allow you to deploy and test your widget directly from the kitchen.
[[ This is very important as you do not need to create and install the cab for test the widget, just using DevMode the widget will go from \workspace\ directly to your device, so you can make changes and see results easily. ]]
Now proceed to build your widget. I suggest you use the analog clock addon as a base. [[ You can use PoyTEST, its much simplier ]]
There are two rules you simply must follow:
1) For every new widget, its CHTWidgetDev.lua file must change the "widgetName" property. It must something unique.
I suggest a naming system of "CreatorName_WidgetName" - that should ensure that the names are unique - there must not any conflict here!
Modify anything else however you'd like. The rest of the fields in that file don't need to be as unique as the "widgetName" property.
2) The 30182CB6_manila mode9 file must follow a special rule: The "Scene" section must not contain any components. See how it looks like in the example addon.
That's how it must look for all new widgets.
[[ Making a widget is like making a puzzle (but much more funny ), you have to put the right pieces in the right places. There is no a fix rule and there is a lot of trial and error. Where to find the right pieces? Co0kie gave us thousand of decompiled lines of Lua code in CHT_Source. Download it from post#6 of CHT 2.0.0 thread. Also look in every published widget's kitchen in CHT thread, Rat_2665, Dunc0001, ZaxXx, Azarbel, Colossus_r, RoryB, MnCessna ... (Sorry I dont remember all right now!) ]]
Once you've done that you can do ahead and run "_Deploy_to_device_in_dev_mode.bat" - that will compile the files, copy them to your device and restart manila.
Then just go to the edit widget menu in CHT - your widget should be at the bottom of the list - add it and test it.
When you have finished making your widget, you can pack it up into a cab file.
To prepare the files for the cab you have to run "_Generate_files_for_cab.bat".
The final files will be in the \cab\_files_final\ folder.
Making the cab file - this is what an addon cab must have:
1) Every last one of those files from \cab\_files_final\ need to be in the cab and they have to be set to be copied to %windows%.
Do NOT set the install dir to %windows%, set the files to be copied to %windows%.
2) The setup.dll that is in the \cab\ folder also needs to be added to the cab.
3) Last, but extremely important, set the install dir to \CHTAddons\^widgetName^ - where ^widgetName^ should be your unique widget name same as in the lua file.
[[ This is really important. If you are not creating a new widget but just editing the mode9 and/or lua files, please do not modify the installation dir in the cab properties, as it is used in the installation process and modification may cause problems in CHT ]]
If you want to test that cab on your device make sure you disable dev mode first ("CHTI.AddonWidgets.DevMode" to 0), so that the dev mode widget you were working on and the newly installed one do not conflict.
A widget must not be installed in both dev mode and as a cab at the same time!
##########################
*** 3) How it works ******
##########################
CHT addons plug into slots that interface with the core layout manager.
There is maximum number of addon slots (that number is 10 for the dev preview beta, but it will be 20 for the final).
Each widget consists of 4 parts:
1) a mode9 file for the CHT widget interface
2) a lua file for the CHT widget interface
3) any number of extra mode9 or lua files
4) xml file with a manila file list for CHTScheduler
Numbers 1-3 there are directly needed for CHT. Number 4 is needed for CHTScheduler (I'll leave the explanation of that for the CHTS thread - it's not need for now if you just want to try to build your own widget).
Numbers 1 and 2 are the most important and they are directly linked to the slots.
Here is how:
The interface mode9 and lua need to have a specific names depending on which slot they go into.
To make this happen those 2 files are dynamically named on install.
While you are developing your widget you are working with the dev widget slot. There is only one of these so it has one pair of mode9/lua names (30182CB6_manila and 7D241726_manila).
But once you make the addon cab the widget can be installed in any slot (first one found to be free). That's why in the release files, there is a CHTmode9_manila and CHTlua_manila.
Those are the same files that you were developing with (30182CB6_manila and 7D241726_manila) - they will be renamed on the fly once installed - this is where the special setup.dll comes in.
The dll will look for the first free addon slot and install the widget there, i.e. it will rename the files so they correspond to the first slot.
The install dir name that you had to specifically enter is used as the widget install ID and will be stored in HKCU\Software\HTC\Manila\ "CHTI.AddonWidgets.SlotX" (this is needed to uninstall the widget correctly).
The files that are being installed should all go to \windows so you set that directly for the files, and that allows the install dir name cab field to be used for this purpose.
Click to expand...
Click to collapse
If you have reached here I recomend you re-read Co0kie's guide, is short but it contains a lot of information, i would say every word is important!
So now the first trial:
1.- Install the kitchen: Every widget has its own kitchen, I have attached a kitchen for a very simple widget. Just download in your PC and copy all the files & folders in a separate folder (\CHTwidgets\PoyTEST\) same as they are inside the .rar
Now connect your PC and your device via USB and sinchronize. Then run the file z_init.bat - You need to run this one before starting. You just need to run it only one time. It will copy restartmanila.exe to you device.
2.- Put your device in DevMode: Go to HKCU\Software\HTC\Manila\CHTI.AddonWidgets.DevMode and change to DWORD =1 (create if does not exit). Now restart Sense.
3.- Run the file _Deploy_to_device_in_dev_mode.bat. Your device will automatically restart Sense. Then go to Edit Mode - Add new element - Select PoyTEST - done. You should see now the simple widget in your device's screen.
It will continue ....
SENSE CRASHED? NO PANIC
It is normal to crash sense when you are doing some experiments, but it normally get solved just deleting files 30182CB6_manila & 7D241726_manila in \windows folder\ and/or dissabling DevMode in registry HKCU\Software\HTC\Manila\CHTI.AddonWidgets.DevMode = 0
rat_2665 said:
It's a tricky thing. Do you use one of Co0kies widgets? For this I "took it over" at first. I didn't change the structure, only made new names in the manila files. You have to check over and over. A blank space in a name in the mode9 file cost me a day. In the next step you can try to change the behaviour.
What you see is the normal screen for an error (i had it often ). Check if all variables in the lua files are also in the mode9 file. Then in the developer mode you can't see errors in the lua scripts (absent end in functions and so on). For this I used sometimes the m9editor, compiled the scripts and looked for errors.
Click to expand...
Click to collapse
Even we can learn from this crashs:
Co0kie Monster said:
Sense nuke and lua "debugging"
The empty screen after adding your widget will happen if there is an error in your widgets lua code. Alternatively it could be a bug in the mode9 file (but those usually cause sense not to start at all), or maybe you left dev mode on and installed your widget via cab - dev mode uses a special widget slot and it will cause a conflict if a widget is installed both via cab and in dev mode at the same time, so remember to turn off dev mode.
But, anyway I'm guessing the problem would usually be in the lua code. In that case you need to debug it. I've uploaded all the needed tools to "Co0kie's Home Tab\_Development\Lua_debugging_tools". (* inlcuded in the widget kitchen)
Because lua is a script It's not really debugging, it's pretty much just a trace log.
Run attach.bat while your device is connected via active sync and that will collect trace information and display any errors along with the file and line where they occurred.
All the info is collected in debug-attached.txt.
Do whatever causes the bug, then run terminate.bat to stop pdebug (that will also restart manila).
Open up the log and look for **Lua Error******.
Other than that you will also see trace() output there.
The other batch (run.bat) is for debugging from startup. You need to turn off manila (WM Settings->Home-> turn off HTC Sense from the list) and then hit run.bat - it will start manila and log at the same time. That's only needed in case of startup errors.
Click to expand...
Click to collapse
HOW TO SOLVE SOME GRAPHICS ISSUES
santod040 about some graphic issues said:
I am not exactly sure yet why the 16 rule only applies to some roms. I think this may actually be the difference between a CFC and non CFC manila.
Though Im digging into this more still.
I also think of this more as one rom listening to the mode9, no matter what the image claims to be or is.
Where the other needs the image to specifically be what it expects, according to the mode9 and lua.
I also think it's more about "4" and "16"
Here's a few key items from Mode9 and a small bit about each.
Though it may be somewhat irrelevant mostly.
String: UTF-16LE encoded strings (represented as UTF-8 in XML and YAML)
Path: UTF-16LE encoded strings (represented as UTF-8 in XML and YAML)
UInt32: 4 byte unsigned integer
Q16: 4 byte Q16.16 fixed point number
Int32: 4 byte signed integer
Boolean: 4 byte, either 1 or 0
Vector3: 3*4 bytes of Q16 numbers (X,Y,Z)
RectQ16: 4*4 bytes Q16 numbers (X,Y,Width,Height)
RectInt: 4*4 bytes of signed integers (X,Y,Width,Height)
Size: 4*2 bytes of Q16 (Width,Height)
Color: 4*1 bytes (R,G,B,A)
Viewport: either a Vector3 or a RectQ16, depends on size
FrameValue: either a Vector3 or a Q16 number, depends on size
BinaryScript: a binary value, encoded as Base64 in the XML or YAML file
The CFC should not be used as a standard.
Heres why:
Non Cfc and Cfc images, will work on a Cfc rom.
Whereas Cfc images will not work right on a non Cfc rom(any stock rom).
So to be universal, non Cfc is the best approach.
Also consider that manila, and your device have to decompress as they use the images.
So, to offer Cfc as an option is nice, but not the universal offering.
Click to expand...
Click to collapse
santod040 said:
Similar issue again.
The qtc needed to be a more accepted dimension by manila.
I still don't have any concrete answers behind it, other then the info I already posted regarding textures and sizes in manila.
So, I adjusted the mode9 and also the qtc to be standard sizes.
I have made a few that worked.
The first was 256x64, but then was hard to move, lol.
So I edited again and made it 512x64 and reposted just now.
It seems to move just fine.
Now only to move the resize button up some and it would be near perfect.
But since it's almost 3am, that will have to wait.
Click to expand...
Click to collapse
santod040 said:
Something else to think about.
As far as the 16 rule.
I also mentioned 4.
So for example,
64 divided by 16 = 4 (good number)
96 divided by 16 = 6 (bad number)
128 divided by 16= 8 (good number)
Click to expand...
Click to collapse
only 10 widget slot problem solution
mike2nl said:
We, the CHT teams, have found a solution for the 10 slots for widget issue.
After we had changed things we are now in state to use 20 widgets(*) at all (0..19).
It is tested on HD2 and TP2 WM phones, and it's running without any issue until now.
The new file was tested by santod040, MichelDiamond, poyensa and me.
My last test was to use 20 widgets on the HD2 about the performance. And yes it does the work .
How to install the fix:
1. unzip the manila file
2. switch off sense
3. copy the 7c60907d_manila file o the \Windows directory
4. restart your phone
5. switch on sense
6. have fun to install more widgets now (max. of 20)
7. follow the install routine from every widget
Click to expand...
Click to collapse
Last but not least, thank you to all involved team members...
Click to expand...
Click to collapse
You can do your own widget just changing PoyTEST - PoyText1 - PoyGraphic1 for your own names
The best way to make a new widget is start from another widget, in this case we can start from PoyTEST, its a simple widget with 2 variables to display in the home screen of our devices: one graphic file as background and one text field. This 2 fields (or variables) will be created by the mode9 file. We have to give unique names for all the variables so the easiest way is just to change PoyTEST - PoyText1 - PoyGraphic1 - for your own names in every line of the files involved. So open file 30182CB6_manila using m9editor and do the changes. (If you are not familiar with m9editro go here)
{
"lightbox_close": "Close",
"lightbox_next": "Next",
"lightbox_previous": "Previous",
"lightbox_error": "The requested content cannot be loaded. Please try again later.",
"lightbox_start_slideshow": "Start slideshow",
"lightbox_stop_slideshow": "Stop slideshow",
"lightbox_full_screen": "Full screen",
"lightbox_thumbnails": "Thumbnails",
"lightbox_download": "Download",
"lightbox_share": "Share",
"lightbox_zoom": "Zoom",
"lightbox_new_window": "New window",
"lightbox_toggle_sidebar": "Toggle sidebar"
}
The mode9 file 30182CB6_manila use to define also the content of the graphic variables (SetTexture) but we will do it later for this example. Other important thing is the order in mode9 stablish the order of the elements shown in ours screen. It means that we will see PoyText1 over PoyGraphic1 as we like.
Now we have to change the file CHTWidgetDev.lua using Notepad2 and change all the PoyTEST - PoyGraphic1 & PoyText1 for the name previously used in the mode9 file. It not dificult just change PoyTEST -nothing else- in every line where it appears, substitute for the name previously used in mode9 file. YES YOU HAVE TO LEAVE THE SMALL w
Some important things:
Be careful with capital and lower letters. For lua languaje 'PoyTEST' is different than 'poyTEST' so only one letter can make the widget not working.
If the line strat with '--' then the line is dissabled, this is usefull for notes & reminders and also to activate and deactivate lines. If you use Notepad2 the deactivated line will be green coloured.
The files 30182CB6_manila (mode9) & CHTWidgetDev.lua always have to be in any CHTwidget, and they must have always the same structure. In mode9 file 30182CB6_manila we do create the variables and in CHTWidgetDev.lua (renamed as CHTlua_manila in the cab) we connect the widget to the rest of Co0kie Home Tab.
Now we do not need to change anything, may be later when we are more familiar with widgets:
* Lines 3-8 is to register the widget in CHT
* Line 8 is connected to line 82-83-84. We define there how many layouts is going to have the widget (black-white-etc). We leave everything as it is now ...
* Lines 10-48 are to control the size of the widget, in the future you can play there a bit specially in line 42 if you wish your widget bigger, but now we leave it as it is.
* Lines 50-62 are very important. We do nothing there -never- just change the names for our's widget name. Specially line 62 we put there the object (clockface, bakcground, etc) that is going to react when we press it with our finger. In our case it will be PoyGraphic1 (change it for the variable name used in mode9 file 30182CB6_manila).
* Line 64 conect to our widget lua file. As you may know the lua file defines the behaviour of the widget. In this lua file we are going to say what our widget is going to do. Is time to open ManilaHash and find the manila name of our widget's lua file. Dont change the path just the final name, you can use any but by convention better use something like CreatorName_WidgetName.lua
* Lines 82-84 is to add more layouts in our widget. You can see some examples in other widgets and also in CHT_Widgets.lua (CHT source), but dont forget to modify line 8 then!
* Lines 88-104 is defined the animation effect how the widget comes to the screen when swipping between levels. I never touch anything there.
* same for lines 106-116. It was there before me and i never modify anything there (just the widget name)
* Now have a look again to every line, check the spelling, capital letters, etc.
Now you are using manilaHash you can also find the name for any other graphic file you are going to use. e. Dont change the path just the final name
Now we can start to modify the file PoyTEST.lua. Using Notepad2 you have to change PoyTEST for your widget name used in the previous lua file and also modify the name of the variables defined in the mode9 file 30182CB6_manila (PoyText1 & PoyGraphic1) in all the lines where those appears.
In this lua file can be added some properties that use to be set in mode9 file (lines 15-25) I do that for one reason: This file does not change the name in the widget installation process, as the other CHT files (CHTmode9_manila & CHTlua_manila) does. This file will be always 41CBC6DC_manila in \windows\ folder so it is easy to substitute later to correct some bugs, etc.
You can get out of the line 29 (just put -- at the begining of the line it will be green cloured) This is a test I am doing for translate widgets regarding this post. If so you have also to activate the line 28 (delete -- then the line will be black colour) and delete file PoyTESTtranslation.lua in \PoyTEST\workspace\_lua
I cannot say much more for this file. Here comes the problems. How to do things? I am not a coder I have only read and read and read a lot of code in other widgets and CHT_Widgets.lua and other files in CHT source, and try and try and try a lot, and finally ask rat_2665
* Line 33 is a way to set texture for graphic fields in lua files instead of mode9 files
* Lines 38-63 is to define what the widget does when pressed
You can do your own widget just changing PoyTEST - PoyText1 - PoyGraphic1 for your own names
Now is time to check the USB conection, device is sinchronized, then click on _Deploy_to_device_in_dev_mode.bat and see your widget working!
[[be sure the .bat file has been edited correctly by adding your widget name, as explained in post#8]]
Sense crashed ... dont worry. Nobody has got it at the first time!
1. Be sure you are in DevMode
2. Check that all the names are correctly written, specially capital letters- lower letters
3. if you got an error in the black screen after run .bat file, read it slowly. It will help
4. Once you make the corrections you can run again .bat, even with sense crashed.
MAKING THE CAB
Co0kie Monster said:
When you have finished making your widget, you can pack it up into a cab file.
To prepare the files for the cab you have to run "_Generate_files_for_cab.bat".
The final files will be in the \cab\_files_final\ folder.
Making the cab file - this is what an addon cab must have:
1) Every last one of those files from \cab\_files_final\ need to be in the cab and they have to be set to be copied to %windows%.
Do NOT set the install dir to %windows%, set the files to be copied to %windows%.
2) The setup.dll that is in the \cab\ folder also needs to be added to the cab.
3) Last, but extremely important, set the install dir to \CHTAddons\^widgetName^ - where ^widgetName^ should be your unique widget name same as in the lua file.
Click to expand...
Click to collapse
Be sure that you have edited the file _Generate_files_for_cab.bat with your own name widget as explained in post#8. By running this file all the lua files will be recompiled automatically and all the files will go from \workspace\ to \cab\_final_files\ If you have a look to the screenshot you will notice that some files names have changed: we will find there CHTlua_manila & CHTmode9_manila. This 2 files will change the name again when the cab be installed in the device, depending the free slot asigned will take the final manila in \windows\ folder in your device. Isn't magic?
Dont forget to add the magic setup.dll. When you add the files into the cab select windows as location. Then in cabinet properties - Installation directory do create a folder in \root\CHTAddons\NameOfTheWidget with the same name as your widget (line 5 of chtwidgetdev.lua) and mark hard-coded-path. Finally save the cab.
CHTScheduler
If we add a xml file named as CHTWidget_NameOfYourWidget.xml (CHTWidget_PoyTEST.xml in this case) directly in \windows\ folder with just a description of the manila files names used in our widget (see some of them as example) this widget will be used by CHTSheduler for diferents profiles, baselines, etc.
It does not seems dificult, isnt it? it simple but if you substitute the qtc file attached 1F88A376_manila, and change the color property for the text in line 17 of PoyTEST.lua to black (0,0,0,255) .... it could be the begining of an usefull widget
1.- Lets do our own CHTwidget
2.- Using JMLMenuSense
3.- Final touches
4.- A Bit of CHTS
Its good to have a look into CHTWidgetDev.lua from Co0kie's Standalone Analog Clock, with extended comments by Co0kie (in green). You have it into the Co0kie's widgets kitchen. We all started here:
-- File name: 7D241726_manila -- \windows\htc\home\scripts\home\chtwidgetdev.luac
-- ##### CHT Wigdet interface file #####
-- this script is an abstraction layer that sits between a widget and the core CHT Layout Manager
-- the template needs to be filled in the correct way, but once it is, the created widget will be plugged into the layout manager
-- and automatically behave like any other CHT widget - be movable, have access to different layout profiles, correct lockscreen behaviour etc.
-- even if I do say so myself, the system is *very* powerful
-- the comments below should provide a good description of the template
-- the primary and most important comments will be marked plainly with --
-- secondary comments will be marked with --// and they will contain some additionl points of interest, but not critical info
-- on your first read through I suggest you stick to just the primary comments
-- lines marked with --%% are commented out code that could be part of a template, but is not needed for this example in particular
-- if you have any other question, hit me in the social group
-- this first line creates a new template file based on 'WidgetTemplate' (defined originally in CHT_core.lua)
--// it's best to make it a local - it can be a global too, but there's really no need since it will not be accessed directly anywhere
--// except in this file - and one less global means less polution in the global namespace which could be very important going forward
local wStandaloneAnalogClock = WidgetTemplate:new()
-- this next step registers the newly created widget with the core CHT Layout Manager
CHTLayoutManager:RegisterWidget(wStandaloneAnalogClock)
-- some basic information needs to be filed in about the widget
-- 'widgetName' field - try to make this name as unique as possible, because it is used to save/load widget registy information
-- the core widgets have plain names (Clock, Appointments, Tasks...), but give your widget unique names to avoid conflicts
-- the simplest unique naming scheme would be to just add your name before the widget name
wStandaloneAnalogClock.widgetName = "Co0kieStandaloneAnalogClock"
-- this defines the text that will appear in the advanced settings/add a widget menu
--// sadly, I could not find a way to make the localization system distributed for every widget so you can't enter localized "IDS_*" strings here
wStandaloneAnalogClock.settingsString = "Standalone analog clock"
-- this defines the category in which the widget will appear in the advanced settings/add a widget menu
wStandaloneAnalogClock.settingsCategory = "Clock"
-- the maximum layout count (the layouts that are cycled by the previous/next button on the popup menu or in the settings menu combo box)
wStandaloneAnalogClock.layoutCount = 1
-- should the widget snap to the center of a page
-- // but "center" isn't really center - it's more like snap to posX == 0, 480, 960..., if that position X is the center of a page depends on how you made your widget
wStandaloneAnalogClock.snapToCenterX = false
-- here you can define default settings for your widget on a "per layout" basis
-- if defaults for a level are not given, it will use {visible = false, layout = 0, posX = 0, posY = 0, scale = 1, pinned = false}
-- the visible, posX and posY fields speak for themselves
-- the layout field is the layout number (can be between 0 and layoutCount-1)
--// scale is used for storing size info for resizable widgets
--// pinned is used for storing the pinned state of pinnable widgets
--%% wStandaloneAnalogClock.defaults["HomeLevel0"] =
wStandaloneAnalogClock.defaults["HomeLevel1"] = {visible = false, layout = 0, posX = 0, posY = 0, scale = 1, pinned = false}
--%% wStandaloneAnalogClock.defaults["HomeLevel2"] =
--%% wStandaloneAnalogClock.defaults["HomeLevel3"] =
--%% wStandaloneAnalogClock.defaults["HomeLandscape"] =
--%% wStandaloneAnalogClock.defaults["CHTLockscreen"] =
-- now come the widget function definitions
-- 'Initialize' - and extremely important function
-- it's called when the widget it loaded for the first time (on startup or when added from the advanced menu)
wStandaloneAnalogClock.Initialize = function(self)
-- these first few lines should be the same for all addon widgets
local newComponent = Component()
WidgetLayer2D:Attach(newComponent) -- you may modify this to be either WidgetLayer2D or WidgetLayer3D -- more info on this later
if not self.addonWidgetID then -- this is very important, every addon widget must have these line - do not modify them
newComponent:SetComponentClipCharacter("CHTWidgetDevSlot")
else
newComponent:SetComponentClipCharacter("CHTWidgetSlot" .. tostring(self.addonWidgetID))
end
self.positionLayer = newComponent
-- these two need to be filled in but they differ depending on how you named your mode9 fields
self.animationLayer = StandaloneAnalogClockAnimationLayer -- the layer that will be animated (fade in/out or any other more interesting effect that you can define - dee below)
self:AddObject(SACFace) -- defines the touch surface that, when touched, will enable the widget to be moved
-- the rest is completely up to you
require("Home\\Scripts\\Home\\Co0kieAnalogClock2") -- the script file that describes the behaviour
-- make sure that all new names that you add are unique so that there are no conflict with built-in widgets or any other addon widgets
-- suggested naming scheme is: yourname_variablename
-- the unique name requirement goes for all objectc in mode9 files, lua global variables and classes
StandaloneAnalogClock = StandaloneAnalogClockClass(StandaloneAnalogClockGroup, SACFace, SACMinuteHand, SACHourHand, SACSecondHand)
end
wStandaloneAnalogClock.GetPosX = function(self)
return self.posX + 128 * (1 - self.scale)
end
wStandaloneAnalogClock.GetPosY = function(self)
return self.posY - 128 * (1 - self.scale)
end
-- GetHeight and GetWidth provide feedback for layout manager so it can know the exact borders of a widget
wStandaloneAnalogClock.GetHeight = function(self)
return 256 * self.scale -- in this the base width of the analog clock is muliplied by the scale
end
wStandaloneAnalogClock.GetWidth = function(self)
return 256 * self.scale
end
-- resizing system definitions - I suggest you skip this part on your first read
wStandaloneAnalogClock.isResizable = true
wStandaloneAnalogClock.rotatingResizeButton = true
wStandaloneAnalogClock.GetResizeRefX = function(self)
return self.posX + 128
end
wStandaloneAnalogClock.GetResizeRefY = function(self)
return self.posY - 128
end
wStandaloneAnalogClock.GetResizeButtonXDelta = function(self)
return 90
end
wStandaloneAnalogClock.GetResizeButtonYDelta = function(self)
return -90
end
wStandaloneAnalogClock.CheckScaleLimit = function(self, scale)
return (scale >= 0.5 and scale <= 1.3), 0.5, 1.3
end
wStandaloneAnalogClock.GetResizeUnit = function(self)
return 128
end
wStandaloneAnalogClock.ApplyScale = function(self, newScale)
self.scale = newScale
local newRadius = self:GetResizeUnit() * newScale
self.animationLayer.Scale = Vector3Property(Vector3(newScale, newScale, newScale))
end
-- these are the layout control functions
-- this example widget has only one layout available, but these function come in very handy for defining multiple layouts
-- this function is run before any of the defined layout functions
-- this should contain something that should be set commonly for any layout
wStandaloneAnalogClock.CommonPreSetLayout = function(self)
StandaloneAnalogClockAnimationLayer.Center.x = SACFace.Size.width / 2
StandaloneAnalogClockAnimationLayer.Center.y = -SACFace.Size.height / 2
if not self:CheckScaleLimit(self.scale) then
self.scale = 1
end
self:ApplyScale(self.scale)
end
-- one of these functions is run depending on the selected layout
-- the string to be shown in the settings menu combo box is also defined here
wStandaloneAnalogClock.layoutName[0] = "[[IDS_NO_ALT_LAYOUTS]]" -- combo box text
wStandaloneAnalogClock.SetLayout[0] = function()
end
-- additional layouts can be defined here
-- the number of functions must match the layoutCount field defined above
--%%wStandaloneAnalogClock.layoutName[1] = "Second layout"
--%%wStandaloneAnalogClock.SetLayout[1] = function()
--%%end
--%%wStandaloneAnalogClock.layoutName[2] = "Third layout"
--%%wStandaloneAnalogClock.SetLayout[2] = function()
--%%end
--%%wStandaloneAnalogClock.layoutName[3] = "Etc"
--%%wStandaloneAnalogClock.SetLayout[3] = function()
--%%end
-- like CommonPreSetLayout this function is run for any of the layouts
-- but it's run after the layout specific function
--%%wStandaloneAnalogClock.CommonPostSetLayout = function(self)
--%%end
-- animation function, they are run when switching between level or adding/removing a widget
-- the basic thing that needs to be done here is make the widget visible or invisible,
-- but you can play around with the animations and put in some eye candy
--// Interopolate can be used with Opacity, Position, Rotation and Scale and some cool effect combinations can be made
--// post in the social group if you need more info
wStandaloneAnalogClock.AnimateIn = function(self, instant, swipeDown)
if instant then
self.animationLayer.Opacity.value = 100
else
self.animationLayer.Opacity:Interpolate(100, 10, 0, Interpolate_Linear)
end
end
wStandaloneAnalogClock.AnimateOut = function(self, instant, swipeDown)
if instant then
self.animationLayer.Opacity.value = 0
else
self.animationLayer.Opacity:Interpolate(0, 5, 0, Interpolate_Linear)
end
end
-- these two functions define what should be run to connect or disconnect widget press actions
-- the functions are called on transition to the lockscreen, edit mode, but also for some smaller details (like when menus are up)
wStandaloneAnalogClock.ConnectPressHandlers = function(self)
StandaloneAnalogClock:ConnectPressHandlers()
end
wStandaloneAnalogClock.DisconnectPressHandlers = function(self)
StandaloneAnalogClockisconnectPressHandlers()
end
-- these two do much the same as the previous functions, but the serve as exceptions for the lockscreen
-- in this case the analog clock should not have any action on the lockscreen
-- but for example, the music player uses these functions to reconnect the play controls on the lockscreen
--%%wStandaloneAnalogClock.ConnectLockscreenHandlers = function(self)
--%%end
--%%wStandaloneAnalogClock.ConnectLockscreenHandlers = function(self)
--%%end
-- this one is used to clear the the widgets selection status
-- in this example when the clock is pressed it sinks in a bit
-- in certain situations, there might be a need to deselect a widget even if it's still under the finger
-- (for example when a side scroll is started)
-- that's when this function is called
wStandaloneAnalogClock.ClearSelection = function(self)
StandaloneAnalogClock:ClearSelection()
end
Click to expand...
Click to collapse
You can try now making your own Clock-CHTWidget, following rat_2665 tutorial:
This is a little guide for clock widgets:
Read at first the widget development guide by Cokie (it's in the below mentioned kitchen) !!!
Step 1 manila hash names
1. Download the kitchen for the analog clock widget by cookie and make a temp folder in there. Copy the files for your analog clock in this folder (best if you have already a working clock for CHT 1.8.5). Save the pictures out of the qtc manila files as png in this folder (this is only useful for oversight). Rename the whole widget with your widget name.
2. Make a list with new names for your text and image objects with manilaHASH.
- the names should be unique. I use my name and a widget number as prefix, f.e. rat_w001_secondHand
- determine the manila hash name. For this use the line
\windows\htc\home\assets\images\Home\VGA\Your_Name.qtc
Save this list. You need it all the time for oversight.
3. Rename your images in the temp directory with the new manila names (this is only useful for oversight); then rename also your manila image files with these names.
4. Delete all files in the workspace\qtc directory and copy your new manila files into this (but not the old 1E1A6CCD_manila and 1EC5924B_manila)
Step 2 mode9 file.
5. Open the mode9 file in the workspace directory. Go in the library to the StandaloneAnalogclockGroup. There are the image and text objects for the clock.
6. If you have more objects in your old 1E1A6CCD_manila file for your analog clock add these objects in the group.
7. Then substitute
- for all objects the Instance value with your new name (f.e. rat_w001_secondHand),
- for the image objects the Texture path with the (here shortend) string that you used for the manila hash name (f.e. .\Assets\Images\Home\VGA\rat_w001_secondHand.qtc)
- for the text objects the String value to the variable used in the lua file (f.e. rat_w001_weekday). If you want to use AMPM like in the normal clock, don't change this value.
8. Change the name of the StandaloneAnalogClockGroup to a unique name (that is used later in the lua files, f.e. rat_w001_ClockGroup)
9. Change the name of the StandaloneAnalogClockAnimationLayer to a unique name (that is used later in the lua files, f.e. rat_w001_ClockAnimationLayer)
10. Save the file.
Now to the lua files.
Step 3 CHTWidgetDev
Substitute all uses of wAnalogClock2 with a unique name (f.e. w_rat_w001_Clock). You can do this in Notepad2 with the Edit/Replace function.
Then substitute in line 69 StandaloneAnalogClockAnimationLayer with the new unique name you used in the mode9 file for the animation layer (f.e. rat_w001_ClockAnimationLayer).
Do the same in line 74, 135, 136, 191, 195 and 212 for all uses of StandaloneAnalogClock (f.e. rat_w001_Clock)
Replace the string in line 28 with the name of your widget (f.e. "rat_w001_clock").
In the next line insert the string that is shown for the widget in the home layout (f.e. "my analog clock").
For an analog clock you don't need to change the next item (""Clock").
In line 70, 135 and 136 is the image object for touching mentioned. You have to substitute "SACFace" with your image object (at best the greatest, f.e. rat_w001_clockface)
The last part is line 73 and 74. In line 73 you have to substitute "Co0kieAnalogClock2" with the name of your special lua script (f.e. rat_w001_clock).
Line 74 is the bridge to your lua script. Here are the arguments of the ClockClass defined that are used in the StandaloneAnalogClockClass.__init function in your special lua file. Of course the name of the function is later also to be changed.
In the example it is:
rat_w001_Clock = rat_w001_ClockClass(rat_w001_ClockGroup, rat_w001_clockface, rat_w001_minuteHand, rat_w001_hourHand, rat_w001_secondHand)
Step 4 special lua file
For naming use the lua script file name you used in the CHTWidgetDev.lua file (rat_w001_clock)
In the first (commentary) line change the location with the new name instead of Co0kieAnalogClock2 and use the manilaHash app with this string:
\windows\htc\home\scripts\home\your_widget_name.luac
Then substitute also the manila name (f.e. -- File name: 1F2E1A7D_manila --\windows\htc\home\scripts\home\rat_w001_Clock.luac )
Substitute all uses of StandaloneAnalogClock with your name (rat_w001_Clock)
Change all uses of SACShowAMPM to your name (rat_w001_ShowAMPM).
That would be all if you only want to make a normal analog clock widget, but if you want to change more you have to go to the central function for the behaviour. For this you have to look in this two functions (these are the old Co0kie names):
StandaloneAnalogClockClass.UpdateTime = function(self)
StandaloneAnalogClockClass.UpdateSecondHand = function(self)
Here the update interval and the rotation of the hands is defined. In Co0kies clock it is pretty simple. If you want to add more functions here is the place. The names of the standard arguments clockGroup, clockFace, minHand, hourHand and secondHand should be unchanged in the whole file. For every other variable and object use your special unique name.
Of course you can add other functions in their own place. You find examples for this in my clock thread.
Now it is testing, testing, testing.
Step 5 bat.files
In the kitchen there are these two files
_Deploy_to_device_in_dev_mode.bat
_Generate_files_for_cab.bat
for handling in the development process.
Here you have to substitute in both files in the second luatool line 35E966AF_manila ..\Workspace\_lua\Co0kieAnalogClock2.lua
with your new widget name and its manila hash name. (in the example: 4C0089BA_manila ..\Workspace\_lua\rat_w001_Clock.lua)
Step 6 CHTS file
Rename the file in the CHTS with your new widget name (f.e. CHTWidget_rat_w001_Clock.xml).
Open the file with the windows editor.
Take your list with the manila hash names and substitute the objects with your new names and the manila names.
For the third line use your widget name and in the fourth line ("description") the string you used in the CHTWidgetDev.lua for the home layout description.
Click to expand...
Click to collapse
This links always useful ...
TUT: Editing manila!
LuaTool 1.2 - Lua Decompiler, Compiler and Compare
TF3D manila mode9 editor
CFC GUI - THE Manila/TF3D Image Editor
Manila file names
Manila CMD Kitchen Environment
Lua 5.1 Reference Manual
Manila Development for Beginners
Example of use of longpress thanks to RoryB
Modifications of the lua script/functions thanks to rat_2665
and reserved5 (i hope is enough )
Great post...I have been wanting to work on my own widget for CHT. Hope this thread will help me jump start...
So here are a few little things I have gathered over the last few months which I have found useful.
The ManilaHash.txt contains two lines of text for you to cut and paste into Manila Hash which you need to generate the correct manila filenames for your widget scripts and qtc image files. Just open Manila Hash, open the txt, copy and paste the relevant line into MH and alter the last bit to your image/script name. Then click Get Manila and you'll have your unique manila filename. Then highlight the hashed name, right click and copy. If it is the name for your widget script you are generating you then need to use this in the two bat files (Deploy to device in dev mode/Generate files for cab) before you run either bat - right click and Edit and you'll see something like this:
Code:
@echo off
pushd tools
luatool /c -o ..\deploy\7D241726_manila ..\Workspace\_lua\chtwidgetdev.lua
luatool /c -o ..\deploy\3DFA729F_manila ..\Workspace\_lua\dunchexclock.lua
copy ..\Workspace\mode9\*.* ..\deploy >nul
copy ..\Workspace\qtc\*.* ..\deploy >nul
copy ..\Workspace\png\*.* ..\deploy >nul
copy ..\Workspace\locales\*.* ..\deploy >nul
copy ..\Workspace\CHTS\*.* ..\deploy >nul
rapicopy -d -e -s ..\deploy \windows
rapistart restartmanila.exe
del /q /s ..\deploy\*.* >nul
pause
NB - The bat files included in the widget kitchen contain notation by co0kie but the code above shows the actual active parts of the bat.
The line you need to change is this one:
Code:
luatool /c -o ..\deploy\3DFA729F_manila ..\Workspace\_lua\dunchexclock.lua
Change the manila name to the one you just generated for the script (highlight/paste from MH) and change the script name to whatever name you are giving your widget script. BTW confusing as it may seem the hashed name is generated using .luac and the bat refers to it as .lua - this is correct!
Also for reference you should also edit the first line in your widget script to show the correct script name and hashed manila filename. Incidentally you'll notice this line in the script has -- at the start. This basically 'disables' the line so it becomes for reference only. This is handy during testing because you can remove elements from use without actually removing the text from the script, so they are easy to add back in later. If you are using Notepad2 which is in the tools folder (and I strongly recommend you do because it is specifically formatted for editing these scripts) you'll see that lines beginning with -- appear in green so you can easily identify inactive lines.
If you have generated a hashed name for a qtc file then simply copy the name, right click on your qtc file and Rename, highlight current filename and paste.
Widget mode9 Filenames.txt contains the hashed filenames for the mode9 files of each widget depending on which widget slot it is installed into. The mode9 and WidgetDev.lua filenames are generated during install depending on the slot number so you will need these if you are going to edit the mode9 after you have actually installed a widget (not relevant if you are still working on it in dev mode). You can also use this list to locate the mode9 file for any widgets you already have installed but which you may want to take a look at for reference or edit.
LUA Ref v5.1.pdf is a really useful quick reference guide for lua syntax, but before you get in a spin trying to get your head around lua for the first time I would strongly recommend reading this BEGINNERS GUIDE. There are many online references including the main LUA Reference Manual (there's a link to it in the site I've just linked to) but this one gives an easy to follow guide to the basics so read it first!
rat_2665's CHTAddon Dev Mode Switch - adds a new toggle switch in the CHT Toggle Switches list. Works like every other toggle to activate/deactivate Dev Mode rather than having to do it manually with a registry editor. Just toggle on/off and soft reset after each change to enter/leave Dev Mode. I'm sure rat won't mind me posting this here - it's all his work so all credit to him for this one - but it really is a timesaver when you are developing!
One final word of advice/experience - when you are first starting out on developing widgets it can be very VERY frustrating, especially if like me you have absolutely no previous experience of coding. However we are all here to help -that's what this community is all about. If you have a problem just ask. And be prepared for many many Sense crashes and resets! But hey, that's what dev mode is there for - another of co0kies little flashes of genius!
Right, that's just to give you all a hand with some basics! We are now open for business - ASK AWAY
Thanks Poy, Rat, Dunc, and all those involved with CHT and CHT widget dev.
This could prove to be very useful for anyone wanting to jump into making their own widgets and for collaborative efforts as well.
I look forward to seeing where this goes from here.
If I decide to add anything to the great info already posted, I will place it here.
Thanks for your efforts to get this going Poyensa.
Excellent thread, hope to try out the tutorial at some point.
At the moment interested in the toggle switches and how to make them, since it's not covered anywhere.
I've opened up rat_2665's toggle switch cab (hopefully that is ok - it is a good example).
The two key files are:
CHT_switch_DevMode.png
CHTlua_manila
The lua code is as follows:
Code:
Co0kieSwitchLink("DevMode Switch", "\\Windows\\CHT_switch_DevMode.png", _application.Store:GetValueChangedEvent(Lifetime_Permanent, "CHTI.AddonWidgets.DevMode"), function(l_1_0)
if _application.Store:GetIntValue(Lifetime_Permanent, "CHTI.AddonWidgets.DevMode") == 0 then
_application.Store:SetIntValue(Lifetime_Permanent, "CHTI.AddonWidgets.DevMode", 1)
else
_application.Store:SetIntValue(Lifetime_Permanent, "CHTI.AddonWidgets.DevMode", 0)
end
end
, function(l_2_0)
if _application.Store:GetIntValue(Lifetime_Permanent, "CHTI.AddonWidgets.DevMode") == 0 then
return false
else
return true
end
end
)
From the above you can identify:
The switch title - "DevMode Switch"
The graphic - "\\Windows\\CHT_switch_DevMode.png"
Trigger - _application.Store:GetValueChangedEvent(Lifetime_Permanent, "CHTI.AddonWidgets.DevMode")
Action - function(l_1_0)
Switch position - function(l_2_0)
The setup.dll in the cab, sorts out the install side (as mentioned in the other posts).
Anyone know what lua file is the wifi switch? Or what regkey it monitors? Thanks.
Sorry if this info is written somewhere else, but I've not been able to find it so far.
meltwater said:
Anyone know what lua file is the wifi switch? Or what regkey it monitors? Thanks.
Sorry if this info is written somewhere else, but I've not been able to find it so far.
Click to expand...
Click to collapse
I would like to know that as well.
ai6908 said:
I would like to know that as well.
Click to expand...
Click to collapse
The wifi switch is in the Co0kieLink.lua file
Code:
Co0kieSwitchLink("[[IDS_WIFI_TOGGLE]]", "\\Windows\\CHT_switch_wifi.png", machineStatus.WifiOn.OnValueChanged
,function()
JMLComm("wifi")
end
,function()
return machineStatus.WifiOn.Value
end)
meltwater said:
Anyone know what lua file is the wifi switch? Or what regkey it monitors? Thanks.
Sorry if this info is written somewhere else, but I've not been able to find it so far.
Click to expand...
Click to collapse
ai6908 said:
I would like to know that as well.
Click to expand...
Click to collapse
Download CHT_AddonLinksKitchen.zip in post#6 of CHT2.0 thread. Inside \workspace\_lua\ you will find decompiled 6ADCC943_manila -- \windows\htc\home\scripts\home\chtlinksdev.luac with comments from co0kie
You beat me to it! BTW, Meltwater in the house - we are honoured
Making new links is actually way easier than making new widgets because there are only very small scripts involved and no mode9. You can either make new links to add in to the existing link sets (Miscellaneous, Toggles, etc) which is really straightforward, or you can create entirely new link sets. I have done both, adding new DatePicker and All People links into the Misc group, and making the new Page Switch Link set. Making a new set is also pretty straightforward although you also have to define the class and function, but most importantly each new set of links must have a unique link ID. This ID needs to be chosen and then notified to the CHT dev group in the Widgets discussion. If you don't have access to it then ask here and we'll provide you with one and feed it back to the dev group.
I can't remember what's in the kitchen Poy just linked to so I have attached my three kitchens below, along with a zip containing the CHT_quicklinks and freelinks luas and one of MichelDiamond's scripts for some of the links he added in for CHTS.
Again, any questions you have keep asking. We're waiting to see what amazing new stuff you come up with...
Dunc001 said:
You beat me to it! BTW, Meltwater in the house - we are honoured
Making new links is actually way easier than making new widgets because there are only very small scripts involved and no mode9.
... ...
Again, any questions you have keep asking. We're waiting to see what amazing new stuff you come up with...
Click to expand...
Click to collapse
Thanks guys. I did look at this when it was released, but found it difficult to get started with it.
That was my theory, make a few switches and get used to the plugins. Thought I could make some custom ones for switching on an in-car mode and various other things (switching into development modes for debugging the tabs would be handy too).
Obviously there is potential for using the stuff I've got for an improved RSSWidget and FbWidget but I'm still working out how to create stuff from scratch (but I am getting there).
Would be interesting to make a widget which displays set text items (perhaps a graphic too) from the registry, with callbacks to an app if pressed. That would be enough for a .net program to tie into, this is the basis of the RSSTab. Such a general widget could be used for a lot of things.
By the way, if you want to use some wiki space, feel free to carve out a chunk!
http://forum.xda-developers.com/wiki/index.php?title=WM6_HTC_Sense_Developer_Wiki
Have you got the CHT RSS widget kitchen? I'll upload it if not. If you could make a widget template for an updated rss widget or Facebook/Twitter widget to look/function in a similar way to the Android sense widgets that would be fantastic. Scrollable, with channel icon/Facebook pic beside each item, and also showing update time. Core CHT tasks and contacts widgets are already scrollable so all the necessary code should be available to copy/adapt. Let us know what you need any help with.
Dunc001 said:
Have you got the CHT RSS widget kitchen? I'll upload it if not. If you could make a widget template for an updated rss widget or Facebook/Twitter widget to look/function in a similar way to the Android sense widgets that would be fantastic. Scrollable, with channel icon/Facebook pic beside each item, and also showing update time. Core CHT tasks and contacts widgets are already scrollable so all the necessary code should be available to copy/adapt. Let us know what you need any help with.
Click to expand...
Click to collapse
I think I'll get my feet wet by doing some toggle switches first.
At the moment don't have the time to do the full widgets yet, got plenty that needs doing on the tab itself, but it would be great to get it all to tie in.
Well, the basics are done. If you miss something let us know. We also will try to bring here some tricks, fixes, mods, etc. And of course the answers for all your questions, excepting the date for next CHT update!
meltwater said:
Would be interesting to make a widget which displays set text items (perhaps a graphic too) from the registry, with callbacks to an app if pressed. That would be enough for a .net program to tie into, this is the basis of the RSSTab. Such a general widget could be used for a lot of things.
Click to expand...
Click to collapse
I totally agree with you.
I am monitoring this thread since its creation and I plan to investigate it when I will have more free time next week.
My goal: modify the RSSWidget to display feed informations from Google Reader (via the "Speeed Reader" application and probably a mortscript to parse the .xml and update registry).
kalhimeo said:
I totally agree with you.
I am monitoring this thread since its creation and I plan to investigate it when I will have more free time next week.
My goal: modify the RSSWidget to display feed informations from Google Reader (via the "Speeed Reader" application and probably a mortscript to parse the .xml and update registry).
Click to expand...
Click to collapse
Well I hope to integrate Google Reader into the RSSTab at some point.
Hi,
Check this new patch - better image quality than previous patch. (tested on defy with green lens, probably work with all rooms)
sample image in attachment.
In attachment 2 new file (compression_02_03.zip) with more compression (02 and 03) - less file size but phone does not freeze when capture very deatiled images.
changelog:
v0.01
- decrease jpg compression (increase file size)
- decrease annoying blurry denoise (increase sharpness, details)
- increase sharpness, details in recording video
how to run:
1. backup system/etc/mot_ise_imager_cfg.bin
2. copy and replace new mot_ise_imager_cfg.bin to system/etc
3. reboot phone and take picture
Please take picture and compare, with same stage/object before and after apply patch (please take few photos before and after apply patch and take best form they)
If anybody wants to experiment with options of defys camera here simple explanation how to make it.
1. Need root
2. Run Root Explorer, copy from PHONE /system/etc/mot_ise_imager_cfg.bin to a safe place (/sdcard/ for example)
3. Copy from PHONE /system/etc/mot_ise_imager_cfg.bin to PC
4. Run hex editor like HxD or other
5. Search 4101 5000 (for example) or 4101 4407 or 4101 XXXX (XXXX means register)
example how to disable denoise:
changes everything 4101 5000 4F to 4101 5000 47 and 4101 5000 CF to 4101 5000 C7 we will disable bit 3 from register 5000, look ov5642 datasheet page 142
bit 3 = de-noise 0:disable 1:enable
hex: 4F = bin: 01001111 - red is bit 3, green is bit 0, blue is bit 7
hex: 47 = bin: 01000111
6. Copy the mos_ise_imager_cfg.bin from PC to PHONE /system/etc
7. Change the permission (press and hold in root explorer) to rw-r--r--
8. Remount /system read-only, reboot, and test.
how to change compression read in:
http://forum.xda-developers.com/showthread.php?t=966800
ov5642 datasheet.
Have fun
Will try, but what's the difference between your and this patch:
http://forum.xda-developers.com/showthread.php?t=966800
Thanks
changelog:
v0.01
- decrease jpg compression (increase file size)
- decrease annoying blurry denoise (increase sharpness, details)
look sample image in attachment
Sorry but i'm little nooby, can you explain how exactly to make this thing run on ours phone.
Pls excuse me for my bad language.
P.S - My phone is with build number: JRDNEM_U3_2.34.1.
franek123 said:
Hi,
Check this new patch - better image quality than previous patch. (tested on defy with green lens, based on: CEE 3.4.2-155-002 Deblur)
sample image in attachment.
changelog:
v0.01
- decrease jpg compression (increase file size)
- decrease annoying blurry denoise (increase sharpness, details)
how to run:
1. backup system/etc/mot_ise_imager_cfg.bin
2. copy and replace new mot_ise_imager_cfg.bin to system/etc
3. reboot phone and take picture
Please take picture and compare, with same stage/object before and after apply patch (please take few photos before and after apply patch and take best form they)
Have fun
Click to expand...
Click to collapse
when you free please explain how to apply this path to all defy with various blur and android version as more than thousands of people want to know how, is supported for all android version? if you dont mind can you make modification to this path so we can have full screen video and phone capture winodows instead of boarder
Thanks in advance
Urvish
When I take photo outdoor, i see only 10% of proper picture, rest is grey. Probably caused by too slow memory card, because 3mpix photos saves good.
1. Need root
2. Run Root Explorer, copy /system/etc/mot_ise_imager_cfg.bin to a safe place (/sdcard/ for example)
3. Copy the mos_ise_imager_cfg.bin contained in the zip file to /system/etc
4. Change the permission (press and hold in root explorer) to rw-r--r--
5. Remount /system read-only, reboot, and test.
If you are not sure about any of the steps, don't do it, it will brick your phone, kill your parents, and burn your skin.
I can't get it to work - tried before and after root using both Astro and Super Manager (does it have to be Root Explorer as mentioned above?). Not able to paste into system/etc/ nor able to delete original mot_ise_imager_cfg.bin.
Yes, you need Root Explorer, and when you go to system/etc, select option mount R/W. Replace file mot_ise_imager_cfg.bin and that's all
It´s works for me, I´m from Argentina and I have the new JBoogie3 BlurGinger based on 3.4.3-11 and u3_3.4.2_164 and really works grat. The colors, the shadows, the contrast you see a different instantly... Great work! Thanks...
P/D: Sorry for my bad English
I have small question to franek123
Could you upload this patch, but without compression-fix ? It seems that's why it is not working good on my, and few user's Defy. Hope you will help
check now - reupload again
Still getting blank images with that patch..
back to original for me.
So is this patch useful?
Sent from my MB525 using Tapatalk
amEx-pl said:
When I take photo outdoor, i see only 10% of proper picture, rest is grey. Probably caused by too slow memory card, because 3mpix photos saves good.
Click to expand...
Click to collapse
me too, with 5mpx, only top area fine, rest area are grey.
but i have class 6 sd card.. i think my sd card is good enough for handling 5mpx picture.
If anybody wants to experiment with options of defys camera here simple explanation how to make it.
1. Need root
2. Run Root Explorer, copy from PHONE /system/etc/mot_ise_imager_cfg.bin to a safe place (/sdcard/ for example)
3. Copy from PHONE /system/etc/mot_ise_imager_cfg.bin to PC
4. Run hex editor like HxD or other
5. Search 4101 5000 (for example) or 4101 4407 or 4101 XXXX (XXXX means register)
example how to disable denoise:
changes everything 4101 5000 4F to 4101 5000 47 and 4101 5000 CF to 4101 5000 C7 we will disable bit 3 from register 5000, look ov5642 datasheet page 142
bit 3 = de-noise 0:disable 1:enable
hex: 4F = bin: 01001111 - red is bit 3, green is bit 0, blue is bit 7
hex: 47 = bin: 01000111
6. Copy the mos_ise_imager_cfg.bin from PC to PHONE /system/etc
7. Change the permission (press and hold in root explorer) to rw-r--r--
8. Remount /system read-only, reboot, and test.
how to change compression read in:
http://forum.xda-developers.com/showthread.php?t=966800
In attachment ov5642 datasheet.
Have fun.
Thank you ,it does better on my defy.I will try this new version.
marhensa said:
me too, with 5mpx, only top area fine, rest area are grey.
but i have class 6 sd card.. i think my sd card is good enough for handling 5mpx picture.
Click to expand...
Click to collapse
I have the same problem
CEE 34.155.2
Well i try the patch and there it's a differend the pictures are much bigger!
After i past the patch my defy was stuck on moto logo damn i freak out tnx god i find way to relive the phone and i'm abso-****ing-lutely happy!!!
fantastic!!!
pictures are much better - thanks
dassRBM v0.9
New since last version:
PNG to LZ32 conversion working.
Some minor bugfixes.
Windows batch files (*.bat) include a PAUSE now.
Some minor source code optimizations.
Noteworthy stuff created with this:
Adfree's replaced Samsung logo
Adfree's ultra slim RC1 file, download here
Hero355's Turko CFW v8 quick panel
Hero355's alternate Turko CFW v8 quick panel
Mylove90's b&w theme, quickpanel, white dial keyboard
Navinng's edited quickpanel
Navinng's new volume control
nip_miniw's green dial keyboard
RuLe89's quickpanel
Yakapa40's brown dial keyboard
Yakapa40's complete redesign
Yakapa40's indicator icon numbers
Usage instructions:
Code:
dassRBM - Usage Guide
~~~~~~~~~~~~~~~~~~~~~
These instructions are written for Microsoft Windows, but should work
for anything else, too. Given that you're able to compile dassRBM for
your system, of course.
To extract a RBM file:
~~~~~~~~~~~~~~~~~~~~~~
[1] Put dassRBM.exe, extract_all.bat and the RBM file into one folder.
[2] Run extract_all.exe.
-> You'll get one .img/.qmg file for each item in the RBM and one
"build" CSV file containing the instructions for rebuild of the RBM
file. The "build" CSV file can be opened using
Excel/OpenOffice/LibreOffice or similar. See "editing build CSV files"
for editing.
To (re)build a RBM file:
~~~~~~~~~~~~~~~~~~~~~~~~
[1] Put dassRBM.exe, build_all.bat, all items to include (img/qmg/png)
and the CSV file into one folder.
[2] Run build_all.exe.
-> All the items will be used as detailed in the CSV file to (re)build
the RBM file.
To analyse RBM files:
~~~~~~~~~~~~~~~~~~~~~
[1] Put dassRBM.exe, summarize_all.bat, and all RBMs to analyse into one
folder.
[2] Run summarize_all.exe.
-> You'll get a comprehensive analysis of all RBM files in
summary_items.csv (for items included in the RBM files) and
sammary_rbms.csv (for RBM overview). Open in
Excel/OpenOffice/LibreOffice or similar.
Editing CSV build files
~~~~~~~~~~~~~~~~~~~~~~~
To completely remove one item:
Just delete the whole line/row corresponding to the item you no longer
want. Rebuild the RBM file (see above). Keep in mind that doing this,
and with it effectively changing the numbering for following items, is
not recommended for RBMs used in Hardware.
To safely remove one item:
Change the value in the "type" column to zero ("0"). Rebuild the RBM
file (see above). The item ordering will be preserved this way, and (as
long as the item is really not used) it is safe to do so.
To add an IMG/QMG as new item or replace existing:
Add a row/line to the CSV file or replace an existing row. ID must be
sequential (no double IDs, IDs in order, same as replaced row),
resolution (width/height) and bpp must be correct. Type is 2 for IMG and
3 or 5 for QMG (refer to the original source for choice between 3/5).
Everything else may be zero (refer to the original source for alpha/mask
anyways for the correct values).
To add a PNG file as new item or replace existing:
Add a row/line to the CSV file or replace an existing row. ID must be
sequential (no double IDs, IDs in order, same as replaced row),
resolution (width/height) must be correct and bpp must be 16 or 32 (32
for better quality and alpha channel). Type is 1. Alpha/mask is zero.
Original first post:
Code:
I took a look at ho1ods discontinued Wave Remaker source code, hoping
that I could code a small command line application for modification of
.RBM files myself.
Here's my findings:
[1] An RBM file is a 'frame' containing one or more images.
[2] The structure of the .RBM file is pretty simple, but the formats
of the embedded images are not.
[3] Four different image formats are used: LZ16, LZ32, QMG16, QMG32.
[4] Most interesting stuff is QMG32 compressed.
Now, I could manage to write the code to handle the RBM structure and
the LZ16/LZ32 formats, but I don't have any idea about QMG. Is there
already such a thing as a working QMG encoder? If not, can anyone code
one?
EDIT: I think I should also write something about this:
[B]What is it good for?[/B]
For a whole lot of stuff! If we're able to edit .RBM files we can change
aspects of the Bada GUI that we haven't been able to change before. We
could effectively do a complete GUI redesign, going far beyound what's
possible with themes. We could finally have Bada Apps with proper icons
in the main menu. We could change the icons in the drop down bar....
etc...
The structure of the .RBM file is pretty simple, but the formats of the embedded images are not.
Click to expand...
Click to collapse
Maybe we could start here.
I have only found position to set 0 x 0 Pixel and to disable...
But not to remove content for valid RBM...
http://forum.xda-developers.com/showpost.php?p=27932409&postcount=124
Maybe "file size" or adresses are stored in RBM ?
But where ?
Best Regards
PshRsrcBmpIdle.rbm
186 Pics
I have disabled ID0 ... first Picture...
PshRsrcBmpIdleAni.rbm
23 Pics
I have disabled ID9 - ID13... :victory:
But now how to remove disabled Pic?
I will do next few days again few tests... maybe I can self find solution for me...
Best Regards
adfree said:
Maybe we could start here.
I have only found position to set 0 x 0 Pixel and to disable...
But not to remove content for valid RBM...
http://forum.xda-developers.com/showpost.php?p=27932409&postcount=124
Maybe "file size" or adresses are stored in RBM ?
But where ?
Best Regards
Click to expand...
Click to collapse
File size and adress are stored inside the RBM header. Let me do it, I'll code something basic just to disassamble (and reassemble) the RBM file.
k8500 said:
File size and adress are stored inside the RBM header. Let me do it, I'll code something basic just to disassamble (and reassemble) the RBM file.
Click to expand...
Click to collapse
And here we go!
Syntax:
To disassemble RBM file
dassRBM -d [Name of RBM] [Name of Listfile]
To resassemble RBM file
dassRBM -a [Name of RBM] [Name of Listfile]
Listfile is created during disassembling and used during reassembling.
If you want to remove images from the RBM, no need to remove them physically, delete them from the list file and reassemble.
If you want to replace an image, keep in mind that the ID (= first 4 Bytes in image file) must match the old one.
Also: Alpha status software, so check the results!
I hope this gets us further!
Sorry, need an while...
libgcc_s_dw2-1.dll is missing in my XP System...
I think their will be more DLLs missing...
Maybe tomorrow I have few tests...
Thanx.
Best Regards
adfree said:
Sorry, need an while...
libgcc_s_dw2-1.dll is missing in my XP System...
I think their will be more DLLs missing...
Click to expand...
Click to collapse
Try using cygwin
adfree said:
Sorry, need an while...
libgcc_s_dw2-1.dll is missing in my XP System...
I think their will be more DLLs missing...
Maybe tomorrow I have few tests...
Thanx.
Best Regards
Click to expand...
Click to collapse
Sorry, should have compiled it differently. Try the attached one.
-> done, 186 file(s) found in file "PshRsrcBmpIdle.rbm"
Click to expand...
Click to collapse
:good:
I have written:
Code:
dassRBM -d PshRsrcBmpIdle.rbm list1.txt
So next file
Code:
dassRBM -d PshRsrcBmpIdleAni.rbm list[B]2[/B].txt
I will do soon with this 2 RBM files some experiments.
Thanx.
Best Regards
Edit 1...
Code:
Disassembling file "PshRsrcBmpIdleAni.rbm" using list "list2.txt"...
000: PshRsrcBmpIdleAni.rbm_000_480x400x32.qmg -> OK!
001: PshRsrcBmpIdleAni.rbm_001_480x400x32.qmg -> OK!
002: PshRsrcBmpIdleAni.rbm_002_480x400x32.qmg -> OK!
003: PshRsrcBmpIdleAni.rbm_003_480x400x32.qmg -> OK!
004: PshRsrcBmpIdleAni.rbm_004_480x400x32.qmg -> OK!
005: PshRsrcBmpIdleAni.rbm_005_480x400x32.qmg -> OK!
006: PshRsrcBmpIdleAni.rbm_006_107x156x32.qmg -> OK!
007: PshRsrcBmpIdleAni.rbm_007_480x400x32.qmg -> OK!
008: PshRsrcBmpIdleAni.rbm_008_3x188x32.qmg -> OK!
009: PshRsrcBmpIdleAni.rbm_009_480x400x32.qmg -> OK!
010: PshRsrcBmpIdleAni.rbm_010_480x400x32.qmg -> OK!
011: PshRsrcBmpIdleAni.rbm_011_480x400x32.qmg -> OK!
012: PshRsrcBmpIdleAni.rbm_012_480x400x32.qmg -> OK!
013: PshRsrcBmpIdleAni.rbm_013_480x400x32.qmg -> OK!
014: PshRsrcBmpIdleAni.rbm_014_480x400x32.qmg -> OK!
015: PshRsrcBmpIdleAni.rbm_015_480x400x32.qmg -> OK!
016: PshRsrcBmpIdleAni.rbm_016_480x400x32.qmg -> OK!
017: PshRsrcBmpIdleAni.rbm_017_480x400x32.qmg -> OK!
018: PshRsrcBmpIdleAni.rbm_018_480x400x32.qmg -> OK!
019: PshRsrcBmpIdleAni.rbm_019_1x1x32.qmg -> OK!
020: PshRsrcBmpIdleAni.rbm_020_1x1x32.qmg -> OK!
021: PshRsrcBmpIdleAni.rbm_021_1x1x32.qmg -> OK!
022: PshRsrcBmpIdleAni.rbm_022_1x1x32.qmg -> OK!
-> done, 23 file(s) found in file "PshRsrcBmpIdleAni.rbm"
If we had a working QMG encoder now, we could edit all that stuff.
...QMG encoder...
Click to expand...
Click to collapse
Theme Creator is helpfull... maybe...
If I extract QMG from RBM then I can see them in Themes...
http://forum.xda-developers.com/showpost.php?p=20091561&postcount=62
But not other direction...
Best Regards
---------- Post added at 04:22 AM ---------- Previous post was at 03:49 AM ----------
:good:
First try...
Removed from list... (list1.txt)
Code:
#[email protected] (171856 byte): 480x800x16, type 3, alpha 1, mask 63519
0:PshRsrcBmpIdle.rbm_000_480x800x16.qmg
First Picture... ID0 ...
Code:
dassRBM -[B]a[/B] PshRsrcBmpIdle.rbm list1.txt
S8500 booting now without Samsung Logo...
Next days I will check deeper... next file is PshRsrcBmpIdleAni.rbm as higher ID as 0...
Thanx k8500 :good:
Maybe someone can help to identify big useless Pictures in RBM files to remove them ...
No idea if this could help to free view Bytes of RAM...
But I will try.
Best Regards
Common users
Appreciate your work guys..
Good luck!
adfree said:
Theme Creator is helpfull... maybe...
If I extract QMG from RBM then I can see them in Themes...
http://forum.xda-developers.com/showpost.php?p=20091561&postcount=62
But not other direction...
Click to expand...
Click to collapse
Is it possible to create QMG in Theme Creator? QMG in .RBM files need a special header, but not very difficult to code something for this.
EDIT: Just give me any 480x800 (32 bit) QMG created in Theme Creator (if possible...), and I'll see what I can do with it tomorrow.
any 480x800 (32 bit)
Click to expand...
Click to collapse
Sorry not much time yet...
But now I see 32 bit... seems not easy, as my Tools are only 24 bpp...
Anyway, I will try to make 2 Pics...
1 black, 1 white...
Give me now 20 minutes...
I think I will then finsished... and upload.
Best Regards
No idea how to create 32 bpp ... compatible for Theme Creator...
Supported Formats...
PNG,JPeG,GIF
I can create 32 bpp with old Corel Draw...
I can only remeber TIF...
Anayway, here is 24 bpp first try.
Only black or white...
Please, correct or add header. :good:
Thanx in advance.
Best Regards
adfree said:
No idea how to create 32 bpp ... compatible for Theme Creator...
Supported Formats...
PNG,JPeG,GIF
I can create 32 bpp with old Corel Draw...
I can only remeber TIF...
Anayway, here is 24 bpp first try.
Only black or white...
Please, correct or add header. :good:
Thanx in advance.
Best Regards
Click to expand...
Click to collapse
Thanks! I'm on vacation now and can't do much, though. I'll see about it later.
Just one remark: 32bpp (for QMG) most likely means 24bpp plus 8 bit alpha channel. So, nothing wrong with using 24bpp input data .
Next file of playing around is Menu.rbm...
31 Pics... 30 of them seems Icons ...
I can't see all...
Maybe I will inject in Theme to check them all...
But first try is to remove ID 1 to 30...
Later I will report.
Best Regards
Edited Menu.rbm and removed 30 Pics...
But Menu seems okay...
But I have lost other ugly stuff...
No idea why...
So for what is Menu.rbm ?
Will check WinComm if Menu.rbm is loaded into RAM... or only Zombie file...
Best Regards
My fault...
Icons are 80x80
So I've reduced HsMenuItem.rbm
At the moment only for test and to identify where Pics are used...
I can see many 0x0 Pixel...
As it seems, maybe no placeholders necessary...
Will check if visible RAM differences...
Best Regards
I will create Batch file...
Take an while...
XXLA1 has 183 files in Black folder... 182 in 2 folders are RBM...
+
OspMapZoomControl.h
Step 1.
Copy all RBM in 1 folder.
Uupsi...
Code:
Disassembling file "W_WsRsrcWheelList.rbm" using list "W_WsRsrcWheelList.txt"...
[B]possibly not a RBM file![/B]
Attached is my Batch...
1.bat and result...
Few files are empty... 0 KB
Best Regards
Edit 2...
Ah, few files have only 0x0 Pix... maybe useless crap...
Edit 3...
System.rbm is not only empty... but txt is empty...
{
"lightbox_close": "Close",
"lightbox_next": "Next",
"lightbox_previous": "Previous",
"lightbox_error": "The requested content cannot be loaded. Please try again later.",
"lightbox_start_slideshow": "Start slideshow",
"lightbox_stop_slideshow": "Stop slideshow",
"lightbox_full_screen": "Full screen",
"lightbox_thumbnails": "Thumbnails",
"lightbox_download": "Download",
"lightbox_share": "Share",
"lightbox_zoom": "Zoom",
"lightbox_new_window": "New window",
"lightbox_toggle_sidebar": "Toggle sidebar"
}
This tutorial is meant for users that want to create from scratch or edit bootanimation.zip files to replace the current ones on their systems.
So let's get to work.
Requirements: a PC, WinRAR / 7-zip, Notepad++ for Windows users, a bunch of frames(images).
Folder structure and general guidelines
The structure of a bootanimation.zip file is: folders (named "part0", "part1", "part2" etc) and a desc.txt file (in charge of animation properties).
So, you can either put all your frames in a single folder and name it "part0" (yes, the name is mandatory), or create more folders if you plan to create a more complex animation such as one that will show a section of your animation multiple times or will make a pause between sections/parts. If you just want to animate one single section, with no special requirements, you can just create a single folder containing all your images.
For more in-depth information on how do the bootanimations work on Android, please, visit this page.
Creating the animation parts/ folders
So, we'll create a folder called part0 and a file called desc.txt. If you want to keep your stuff organized, you can throw them both in another folder and name it whatever you want. You're not going to use that anyway. It's just to keep your stuff organized.
We'll now fill in the folder with slides from the first section of the animation. For this case, we want the animation to run the first section (part0) only once, then move to the second one (part1) and keep that in a continuous loop until Android starts.
The image format, for as far as I know, can be any common format, but I only worked with .png so I would recommend using this format.
The image titles can also be anything you want BUT remember to put the slides in an organized fashion, starting with 0.
For example: if you want to name your images "img000.png", "img001.png", "img002.png" etc, that's fine, but start the counting with 0 and name them all in a similar way, meaning no "ImG000.png", "image001,png", "imag002.png" and so on so forth. Stick to a single way of naming them.
I would personally recommend the easiest way: "000.png", "001.png", "002.png" etc.
Ok, now we'll create a second folder at the same location, and we'll call this one part1. In this folder we'll put the rest of the slides we want it to animate until Android starts.
Now that we have all the images in place, let's move to the next step.
Creating the animation's "control panel"
The "desc.txt" is one of the most important parts of the bootanimation.zip file. It controls basically everything related to that animation.
So make sure to use Notepad++ (if you're using Windows) for editing that file and set it up for UNIX systems (this is important!).
If you're using Linux, you can just edit it with no worries using the built-in gEdit editor.
Now let's open it up in Notepad++/ gEdit and set it up to animate our images the way we want.
But first, let's understand a little bit what exactly can be set up in the desc.txt file.
Code:
[animation width; in px] [animation height; in px] [fps]
480 102 24
[part descriptor*] [nr of loops; 0 = infinite loop] [pause - in seconds] [destination folder]
p 1 0 part0
[part descriptor**] [nr of loops; 0 = infinite loop] [pause - in seconds] [destination folder]
c 0 0 part1
*The "p" descriptor tells the system to stop playing the animation if the boot-up process has finished.
**The "c" descriptor tells the system to continue playing the animation until the boot-up process has finished. This method helps on porting the same animation across multiple platforms because the boot-up time differs from one device to another.
So, in English, what this tells to the system is that it wants it to play an animation having width=480px and height=102px at a rate of 24 fps, in two parts:
1st part needs to be played once, with no pause before the next part or loop (if it's set to continue in an endless loop).
2nd part needs to be played in an endless loop, with no pause between loops, until Android starts.
The width and height of the animation have to be the ones of the images you're going to use.
For example: If you've got 480x102px images, the desc.txt file should also contain 480(width) 102(height) in it.
Note: If you've got images bigger than your physical screen resolution, it will play only the visible part.
So, your finished content of the desc.txt file, should look somewhat similar to this:
Code:
480 102 24
p 1 0 part0
c 0 0 part1
Now that we've got everything set up and ready to use we can proceed to the last step.
Creating the zip file
Now, if you had enough patience to read this whole tutorial, I will ask you to have some more because this part is really important.
When creating the bootanimation.zip file, make sure you set the compression level/method to Store. Both WinRAR and 7-zip support this. This is very important! Without it, your animation won't play and you'll most likely see a black screen during boot time.
You need to select the folders (part0, part1 etc) and the desc.txt file inside your working folder and create a zip archive of that. DO NOT ARCHIVE THE WHOLE WORKING FOLDER!
Ok, now that we've got the animation content zipped in a single bootanimation.zip file, all we need to do is to copy-paste it into /system/media folder on our phone and replace the current bootanimation.zip file from there.
After that, we need to set permissions 644 for the zip file (as described below) and reboot the phone.
That's all folks. Now you know how to create/edit a bootanimation.zip.
Examples
Without Google logo
Link 1: resolution 480x102px
Link 2: resolution 800x170px
Link 3: resolution 1080x230px
With Google logo (original version)
Link 1: resolution 480x102px
Link 2: resolution 800x170px
Link 3: resolution 1080x230px
DO NOT FLASH THESE ZIP FILES IN CWM!
1. Download the bootanimation.zip file somewhere on your phone
2. Copy-paste it into /system/media, replacing the current file
3. Set permissions to 644 for the zip file
4. Reboot and enjoy.
If you're planning on going back to your previous boot animation, make a backup of the current zip file somewhere on your phone before replacing it with some of the ones above.
N-Joy.
First! Thanks for that great tutorial. It's been a long time since I wanted to create my own, but was lazy enough to learn. Now everything is in one place.
And a screenshot... I appreciate that, bro!!! :thumbup:
Sent from my GT-I8150 using Tapatalk 4 Beta
That's a nice TuT!
Reminds me of a bootanimation I made a while ago for my Nexus 7. The most low-res thing ever made, because I couldn't find a Cid-head with high resolution
See here:
Thanks, it is awesome. I want to try all first and will report you which resolution suits me best
Sent from my CM10.1 Kernel 3.4 Wonder by arco using xda premium
very very nice thread, thanks :cyclops::cyclops::cyclops::cyclops:
help
HTML:
When creating the bootanimation.zip file, make sure you set the compression level/method to Store. Both WinRAR and 7-zip support this. This is very important! Without it, your animation won't play and you'll most likely see a black screen during boot time.
how shud i set the compression method on windows7?? help please, thank you
Set it to "store" on Windows 7 using either 7 Zip or Win Rar.
Sent from my Wicked SGS3 using AnaKonda Tapatalk
muzaffarkhan95 said:
HTML:
When creating the bootanimation.zip file, make sure you set the compression level/method to Store. Both WinRAR and 7-zip support this. This is very important! Without it, your animation won't play and you'll most likely see a black screen during boot time.
how shud i set the compression method on windows7?? help please, thank you
Click to expand...
Click to collapse
As described in the screenshot.
Sent from my GT-I9195 using Tapatalk
Like this guide, but I love official google bootanimation.
Also, nexus bootanimation is good, I think.
And, I don't like cm bootanimation.
The 'c' in desc.txt dont work. Android 4.4.2 plays the animation until the 'c' part come than it stops there... why? If I replace the 'c' with 'p' then it works so looks like an invalid command or else :/
arsradu said:
This tutorial is meant for users that want to create from scratch or edit bootanimation.zip files to replace the current ones on their systems.
So let's get to work.
Requirements: a PC, WinRAR / 7-zip, Notepad++ for Windows users, a bunch of frames(images).
Folder structure and general guidelines
The structure of a bootanimation.zip file is: folders (named "part0", "part1", "part2" etc) and a desc.txt file (in charge of animation properties).
So, you can either put all your frames in a single folder and name it "part0" (yes, the name is mandatory), or create more folders if you plan to create a more complex animation such as one that will show a section of your animation multiple times or will make a pause between sections/parts. If you just want to animate one single section, with no special requirements, you can just create a single folder containing all your images.
For more in-depth information on how do the bootanimations work on Android, please, visit this page.
Creating the animation parts/ folders
So, we'll create a folder called part0 and a file called desc.txt. If you want to keep your stuff organized, you can throw them both in another folder and name it whatever you want. You're not going to use that anyway. It's just to keep your stuff organized.
We'll now fill in the folder with slides from the first section of the animation. For this case, we want the animation to run the first section (part0) only once, then move to the second one (part1) and keep that in a continuous loop until Android starts.
The image format, for as far as I know, can be any common format, but I only worked with .png so I would recommend using this format.
The image titles can also be anything you want BUT remember to put the slides in an organized fashion, starting with 0.
For example: if you want to name your images "img000.png", "img001.png", "img002.png" etc, that's fine, but start the counting with 0 and name them all in a similar way, meaning no "ImG000.png", "image001,png", "imag002.png" and so on so forth. Stick to a single way of naming them.
I would personally recommend the easiest way: "000.png", "001.png", "002.png" etc.
Ok, now we'll create a second folder at the same location, and we'll call this one part1. In this folder we'll put the rest of the slides we want it to animate until Android starts.
Now that we have all the images in place, let's move to the next step.
Creating the animation's "control panel"
The "desc.txt" is one of the most important parts of the bootanimation.zip file. It controls basically everything related to that animation.
So make sure to use Notepad++ (if you're using Windows) for editing that file and set it up for UNIX systems (this is important!).
If you're using Linux, you can just edit it with no worries using the built-in gEdit editor.
Now let's open it up in Notepad++/ gEdit and set it up to animate our images the way we want.
But first, let's understand a little bit what exactly can be set up in the desc.txt file.
Code:
[animation width; in px] [animation height; in px] [fps]
480 102 24
[part descriptor*] [nr of loops; 0 = infinite loop] [pause - in seconds] [destination folder]
p 1 0 part0
[part descriptor**] [nr of loops; 0 = infinite loop] [pause - in seconds] [destination folder]
c 0 0 part1
*The "p" descriptor tells the system to stop playing the animation if the boot-up process has finished.
**The "c" descriptor tells the system to continue playing the animation until the boot-up process has finished. This method helps on porting the same animation across multiple platforms because the boot-up time differs from one device to another.
So, in English, what this tells to the system is that it wants it to play an animation having width=480px and height=102px at a rate of 24 fps, in two parts:
1st part needs to be played once, with no pause before the next part or loop (if it's set to continue in an endless loop).
2nd part needs to be played in an endless loop, with no pause between loops, until Android starts.
The width and height of the animation have to be the ones of the images you're going to use.
For example: If you've got 480x102px images, the desc.txt file should also contain 480(width) 102(height) in it.
Note: If you've got images bigger than your physical screen resolution, it will play only the visible part.
So, your finished content of the desc.txt file, should look somewhat similar to this:
Code:
480 102 24
p 1 0 part0
c 0 0 part1
Now that we've got everything set up and ready to use we can proceed to the last step.
Creating the zip file
Now, if you had enough patience to read this whole tutorial, I will ask you to have some more because this part is really important.
When creating the bootanimation.zip file, make sure you set the compression level/method to Store. Both WinRAR and 7-zip support this. This is very important! Without it, your animation won't play and you'll most likely see a black screen during boot time.
You need to select the folders (part0, part1 etc) and the desc.txt file inside your working folder and create a zip archive of that. DO NOT ARCHIVE THE WHOLE WORKING FOLDER!
Ok, now that we've got the animation content zipped in a single bootanimation.zip file, all we need to do is to copy-paste it into /system/media folder on our phone and replace the current bootanimation.zip file from there.
After that, we need to set permissions 644 for the zip file (as described below) and reboot the phone.
That's all folks. Now you know how to create/edit a bootanimation.zip.
Examples
Without Google logo
Link 1: resolution 480x102px
Link 2: resolution 800x170px
Link 3: resolution 1080x230px
With Google logo (original version)
Link 1: resolution 480x102px
Link 2: resolution 800x170px
Link 3: resolution 1080x230px
DO NOT FLASH THESE ZIP FILES IN CWM!
1. Download the bootanimation.zip file somewhere on your phone
2. Copy-paste it into /system/media, replacing the current file
3. Set permissions to 644 for the zip file
4. Reboot and enjoy.
If you're planning on going back to your previous boot animation, make a backup of the current zip file somewhere on your phone before replacing it with some of the ones above.
N-Joy.
Click to expand...
Click to collapse
How to make the png image series of the frames ? Which software should I use to make the frames. (I am not talking about frames from video of gif file)
nice guidelines of that
@arsradu
Hi Arsradu
I hope you can help me
I wanted to change the boot animation of a custom rom (Epic rom 7.8.24 on Xiaomi Mi Mix - MIUI 9 -).
I remplaced five stock pictures by 5 others, .pgn, same size (1080*2040), same name (01, 02...05).
Compression method to Store. Renamed in "bootanimation.zip".
But the animation isn't functionnal : black screen
The code is the same than stock bootanimation :
Code:
1080 2040 5
p 0 5 part0
Permissions file are 644.
There isn't the third line "c" like you.
When i try with the c line, after reboot this line is deleted automatically.
Do you know where is the problem ?
I uploaded the stock zip and my zip.
Thank you.
M.gllmt
m.gllmt said:
@arsradu
Hi Arsradu
I hope you can help me
I wanted to change the boot animation of a custom rom (Epic rom 7.8.24 on Xiaomi Mi Mix - MIUI 9 -).
I remplaced five stock pictures by 5 others, .pgn, same size (1080*2040), same name (01, 02...05).
Compression method to Store. Renamed in "bootanimation.zip".
But the animation isn't functionnal : black screen
The code is the same than stock bootanimation :
Code:
1080 2040 5
p 0 5 part0
Permissions file are 644.
There isn't the third line "c" like you.
When i try with the c line, after reboot this line is deleted automatically.
Do you know where is the problem ?
I uploaded the stock zip and my zip.
Thank you.
M.gllmt
Click to expand...
Click to collapse
Hi,
It's been a while since I've written this tutorial. lol.
I took a look at the files you provided. So, the stock animation works, but yours shows a black screen? In my experience, this occurs because of the compression method not being set to Store. Or the permission not being 644. If you say the only thing different about your zip, compared to the stock one, are the actual png files, then I really don't know what to say. Can you check the compression method on the original zip? Maybe that particular one is not set for Store... Maybe it's set to something else? I don't know.
For the c line, I think you might need a second batch of frames added to a part1 folder. Since you only have 5 frames, I don't think there is a point for that. To be honest, I can't test this anymore since I'm no longer using that phone, and I don't use a rooted phone anymore. ) But that doesn't mean I can't try to help you either way.
arsradu said:
Hi,
It's been a while since I've written this tutorial. lol.
I took a look at the files you provided. So, the stock animation works, but yours shows a black screen? In my experience, this occurs because of the compression method not being set to Store. Or the permission not being 644. If you say the only thing different about your zip, compared to the stock one, are the actual png files, then I really don't know what to say. Can you check the compression method on the original zip? Maybe that particular one is not set for Store... Maybe it's set to something else? I don't know.
For the c line, I think you might need a second batch of frames added to a part1 folder. Since you only have 5 frames, I don't think there is a point for that. To be honest, I can't test this anymore since I'm no longer using that phone, and I don't use a rooted phone anymore. ) But that doesn't mean I can't try to help you either way.
Click to expand...
Click to collapse
Thank you for your reply !
Yes i was in 2013, sorry ^^
But you make me realize on thing : if the compression and extension are ok, and the desc file too, the problem comes from pictures.
I was using 1080*2040 because it is my screen size, but the stock MIUI boot pictures are 1080*1920. I don't know why, but i used this dimension and IT' S FUNCTIONNAL ! I'm Happy :highfive:
Thank you
m.gllmt said:
Thank you for your reply !
Yes i was in 2013, sorry ^^
But you make me realize on thing : if the compression and extension are ok, and the desc file too, the problem comes from pictures.
I was using 1080*2040 because it is my screen size, but the stock MIUI boot pictures are 1080*1920. I don't know why, but i used this dimension and IT' S FUNCTIONNAL ! I'm Happy :highfive:
Thank you
Click to expand...
Click to collapse
LOL. So, I guess there is one more reason why you could see only a black screen: the frames sizes. The more you know. ) 4 years later, I'm still learning new things.
I'm glad you got it fixed. Great job!
I have a problem. My system boots up a lot faster than it it is want it to. So is there a way to forcibly execute all the parts even if the system is booted up. I mainly want to know about how should I use the descriptor.
(I know the last descriptor should be 'p' descriptor)
This is the desc.txt of a bootanimation zip which executes all the parts at least once even if the system has booted. I don't know how that works. Maybe it has something to do with the '0' and '1' written after the part numbers.
Problem with 3 parted bootanimation
So I have the problem that my Bootanimation consists of 3 parts "part0", "part1" and "part2" but part2 is never played. I have also numberd every single picture right and the "desc.txt" file shouldn't be wrong too.
desc.txt file:
Code:
1080 1920 30
c 1 0 part0
c 0 0 part1
c 1 0 part2
I hope some one can help me with that.