{"id":13744447,"url":"https://github.com/spritebuilder/SWF-Importer","last_synced_at":"2025-05-09T03:31:58.099Z","repository":{"id":13720341,"uuid":"16414484","full_name":"spritebuilder/SWF-Importer","owner":"spritebuilder","description":"Air tool to convert fla/swf to SpriteBuilder CCB format","archived":false,"fork":false,"pushed_at":"2015-03-04T06:41:04.000Z","size":1944,"stargazers_count":20,"open_issues_count":1,"forks_count":11,"subscribers_count":17,"default_branch":"master","last_synced_at":"2024-08-04T05:04:12.603Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"ActionScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/spritebuilder.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2014-01-31T17:07:44.000Z","updated_at":"2021-06-15T12:18:29.000Z","dependencies_parsed_at":"2022-09-23T14:31:17.413Z","dependency_job_id":null,"html_url":"https://github.com/spritebuilder/SWF-Importer","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spritebuilder%2FSWF-Importer","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spritebuilder%2FSWF-Importer/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spritebuilder%2FSWF-Importer/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/spritebuilder%2FSWF-Importer/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/spritebuilder","download_url":"https://codeload.github.com/spritebuilder/SWF-Importer/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224811009,"owners_count":17373901,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-03T05:01:09.625Z","updated_at":"2024-11-15T16:30:59.456Z","avatar_url":"https://github.com/spritebuilder.png","language":"ActionScript","readme":"SWF Importer \n===================\n\nConvert your Flash animations to SpriteBuilder.\n\nLooking for support? Please visit the [SpriteBuilder Forum](http://forum.spritebuilder.com/).\n\n## Download\n\nThe easiest way to get started is to download the app please see [Releases](https://github.com/cocojoe/Flash2CCB/releases) for a binary.\n\nIf you want to try it right now, then download the conversion ready [Tutorial Content](https://github.com/cocojoe/SWF-Importer/tree/master/Tutorial%20Content). Then skip to the Conversion section of this Readme for more information.\n\n## Want to roll you rown?\nThe easiest way to build this app is to use Adobe Flash Builder 4.7+:  \n - Simply checkout this repository and then select `File/Import Flash Build Project`.  \n - Select the repository folder and click `Finish`.\n - Then select `Run/Run`.\n\nYou could possibly use [Apache Flex](http://flex.apache.org/) to build, however this is an exercise for the reader.\n\n## Conversion Tutorial\n\nThis tutorial will cover the process of converting an existing FLA animation to [SpriteBuilder](http://www.spritebuilder.com/), you will be using some awesome artwork kindly donated by Vincent Le Quang, Melissa Wallace and Anna Klonoff. \n\n - [Pika](https://github.com/jacklehamster/herosmasks/raw/master/Vincent/Flash/pika.fla)\n\n`Note:` You will require both FLA source files and the published SWF for any content you wish to convert.\n\n## Preperation\n\nOpen pika.fla (CS5+), you should see a few funky looking creatures in various colours.  To keep things clean create a `New Document` and select `ActionScript 3.0`, I called it bluebeast.fla.\n\nSelect the blue creature from `pika.fla` and copy this into the new `bluebeast.fla` document. \n\nDouble click the `Pika run` symbol from the library.\n\nHit play to watch this majestic beast run like the wind, would make a nice endless runner character....\n\n## Getting ready to export\n\n**Step 1)** In the library view open properties for Pika run and ensure advanced options are expanded, tick the `Export for ActionScript`, then tick `Export in frame 1`, the base class should be `flash.display.MovieClip`.\n\nGreat this will now be picked up as an animation for the conversion tool, you then need to ensure all of the component parts of this animation can be exported as textures.  You can see various symbols such as Eye, EarFront and Horn in the Library view.\n\n**Step 2)** Select all of the symbols from `BackLeg` down to `Tail`, ensure `Pika Run` is not part of this group selection and then edit properties.\n\n**Step 3)** Tick `type` and ensure `Movie Clip` is selected from the drop down.  Tick `Export for Actionscript` and change the dropdown to `Yes`, don't worry about any warnings. Tick `Export in frame 1` andchange the dropdown to `Yes`.  Tick the `Base class` and enter `flash.display.Sprite`. Hit OK.\n\n**Step 5)** Hit Publish\n\nOk you will most likely have some `Compiler Errors`. Not a problem, let's fix this right now, double click the first error message. A window will popup, clear the text `stop();`, close that window and save. Hit Publish again, great, it should be all working now.\n\n## Conversion\n\nOpen SWF Importer\n\n**Step 1)** Select the directory containing your bluebeast FLA and published SWF files. (I find it best to put these files in their down directory)\n\nYou should see `bluebeast` listed in the **Conversion Summary**, if valid does not say Yes then you need to go back and check you followed the previous steps correctly.\n\n**Step 2)** Select an export directory, if you want to export into an existing SpriteBuilder project then select the `SpriteBuilder Resources` folder inside the desired `.spriteBuilder` project.\n\n`Note:` As of SpriteBuilder 1.2 this folder will be `Packages\\SpriteBuilder Resources.sbpack`\n\n**Step 3)** Select the bluebeast and hit `Preview`, looking good. Close this window.\n\n**Step 4)** Hit Export All.\n\nYou should now have a file called bluebeast_pikarun.ccb and a bluebeastAssets folder in your export directory. If you exported directly into your project these files will now appear in your project resources.\n\n## SpriteBuilder\n\nGreat let's see these in action in SpriteBuilder. If you didn't drop these straight into an existing SpriteBuilder project, you can easily create one try it.\n\n`Note:` The CCB export has been tested against SpriteBuilder 1.1\n\n**Step 1)** Create a new project, I called it 'bluedemo', it will open up the MainScene.  Right click on `MainScene.ccb` in the File view and select `Show in Finder`.\n\n**Step 2)** Copy the files from the export into this directory and then click back to the SpriteBuilder view. In a couple of seconds you will see `bluebeat_pikarun.ccb` appear in `File view` tab.\n\n**Step 3)** Open this CCB and hit play, you should see the bluebeast running. That's it! \n\n## Common issues that cause \"ERROR\" in the converter\n- The timeline of the animation symbol you want to publish cannot contain another symbol inside. The items in the timeline should contain/use only tweens.\n- Make sure that the publish target inside the Publish Setting is set to the latest Flash Player version. Publshing the animation with old Flash Player versions can cause an error.\n- The final animation that you want to convert should be in a symbol, not a scene.\n- All the tweens used in the timeline must be present in the library section when publishing the animations.\n- The published .swf file should have the exact same name with the .fla file.\n\n## Common issues that cause \"Missing texture\" in SpriteBuilder\n\n- The converted ccb files and assets folder should be copied into the root folder of the SB package. If they're placed inside another folder(s), it will cause the \"missing texture\" issue in SpriteBuilder.\n\n## Credits\n\n- The guys that did a load of hardwork, [Three Rings](https://github.com/threerings)\n- SWF Importer/Ux/Conversion Tutorial, [Martin Walsh](http://github.com/cocojoe)\n- Tutorial Flash content: Vincent Le Quang, Anna Klonoff and Melissa Wallace\n\n### Maintainers\n\n- [Martin Walsh](http://github.com/cocojoe)\n- [Support Forum](http://forum.spritebuilder.com/)\n\n## License\n\nSee the LICENSE file for more info.\n","funding_links":[],"categories":["Apps \u0026 Tools"],"sub_categories":["Development Tool"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspritebuilder%2FSWF-Importer","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fspritebuilder%2FSWF-Importer","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fspritebuilder%2FSWF-Importer/lists"}