Log inRegister an accountBrowse CSDbHelp & documentationFacts & StatisticsThe forumsAvailable RSS-feeds on CSDbSupport CSDb Commodore 64 Scene Database
  You are not logged in - nap
NuCrunch V1.0.0   [2018]

NuCrunch V1.0.0 Released by :
ChristopherJam

Release Date :
30 May 2018

Type :
Other Platform C64 Tool

User rating:awaiting 8 votes (7 left)   See votestatistics

Credits :
Code .... ChristopherJam
Test .... Ian Coog of HVSC Crew
  Krill of Plush

Download :

Look for downloads on external sites:
 Pokefinder.org


Summary
Submitted by ChristopherJam on 21 August 2018
from the readme:

Requirements
============

Building nucrunch requires
- rust 1.26 or later, from rust-lang.org
- ca65, from cc64.org

The test suite also requires
- xa65 (from http://www.floodgap.com/retrotech/xa/)
- Python (either 2.6+ or 3.0+ are fine)
- Numpy ('sudo pip install numpy' should sort you for that)



Building
========

make
cp target/release/nucrunch ~/bin # or whever you keep your executables



Testing
=======

make sea ; test self extracting archive creation

cd tests
make run ; test decrunch
make rrun ; test rdecrunch

Each of the latter tests
- decrunches a fullscreen koala in two segments,
- performs a CRC check (green border for success, red for failure)
- waits one second
- decrunches an update,
- CRC checks the update.

First image is concentric circles with a rect of grey-on-grey noise
Second image is just the concentric circles.



Usage
=====

nucrunch [FLAGS] [OPTIONS] <inputs>... --output <OUTPUT.PRG> <--sea|--load 0xLOAD_ADDRESS|--end 0xEND_ADDRESS|--auto>

Note that you must select one of the sea, load, end or auto options.



Self Extracting Archives
========================

For a simple repack to a self extracting .prg:
nucrunch -xo output.prg onefileinput.prg


By default, self extracting archives
- instead of using SEI/CLI, turn off the CIA interrupt for you and leaves it off.
- sets $01 to RAM only during decrunch,
- reenables ROMs and IO before passing control to the decompressed executable
- starts the decompressed executable by jumping to $080d

Most of these behaviours are configurable, cf. nucrunch --help for details.

If repacking someone else's code doesn't work, try adding the -b or -I options;
some inputs assume end of basic is set, or that the CIA timer is still running



Using as a library for multiple groups of chunks
================================================

Use commas to delineate groups, eg
nucrunch f1g1.prg f2g1.prg, f1g2.prg, f1g3,prg f2g3.prg f3g3.prg -o out.prg -l 0x1000

Call decrunch to unpack the first group, then decrunch_next_group for each subsequent group

Include either decrunch.a65 or ndecrunch.a65 in your executable, depending on your compression direction

Define NUCRUNCH_ALIGN_FOR_SPEED to optimise alignment. (Currently only available with the .a65 sources;
aligning things with ca65 is a bit more fiddly.)

to decrunch using rdecrunch:

ldx #<decrunch_src ; where decrunch_src is the byte after the end of the crunched data (load_end)
lda #>(decrunch_src-1)
jsr decrunch

to decrunch using decrunch:

ldx #<decrunch_src
lda #>decrunch_src
jsr decrunch

See examples in the test directory for more details.
Search CSDb
Advanced
Navigate
Prev - Random - Next
Detailed Info
· Summaries (1)
· User Comments (8)
· Production Notes
Fun Stuff
· Goofs (1)
· Hidden Parts
· Trivia
Forum
· Discuss this release (13)
Support CSDb
Help keep CSDb running:



Funding status:




About this site:
CSDb (Commodore 64 Scene Database) is a website which goal is to gather as much information and material about the scene around the commodore 64 computer - the worlds most popular home computer throughout time. Here you can find almost anything which was ever made for the commodore 64, and more is being added every day. As this website is scene related, you can mostly find demos, music and graphics made by the people who made the scene (the sceners), but you can also find a lot of the old classic games here. Try out the search box in the top right corner, or check out the CSDb main page for the latest additions.
Home - Disclaimer
Copyright © No Name 2001-2024
Page generated in: 0.091 sec.