You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+11-4Lines changed: 11 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -12,36 +12,43 @@ VCC directly models the "stock" 128k Coco 3 and is expandable to many levels tha
12
12
4. "SuperIDE Hard Drive Controller" - emulates dual IDE hard drives, the same model produced by Cloud 9 and will also use Compact Flash memory card images much like the real SuperIDE.
13
13
5 "Orchestra90cc" - a 5 voice music sequencer emulating the original prgram pack of the same name in cluding the stereo 8 bit DACs whitch play in stereo through your PC speakers.
14
14
15
+
We welcome all bug reports and suggestions. Post any bug reports and/or suggestions on the "Issues" page and we will be promptly notified. We do a "check list" of the issues page every-so-often to see if there's any "quick fixes" we can add while we are working on current changes. The VCC Developement Team is a small one and we work on this when we can as we all have lives and families, so VCC is NOT a priority but a hobby. Even being a hobby, it is also a work of love as we also use this software ourselves, so we try to make it as usable as possible. Sometimes progress is slow and it looks like nothing is going on (and it may not be), but usually, there's plenty going on behind the scenes and we have not committed our current work. Progress is slow, but progress is being made.
16
+
15
17
16
18
# Compiling the VCC Sources
17
19
Build Environment - Currently, VCC is compiled in C/C++ using "Microsoft Visual Studio 2015 Community", which is a free download from the MSDN downloads.
18
20
Support Packages - Include "Win x86", & "XP" support packages ("DirectX 9" should be in one of these packages, if not, you must include that as well)
21
+
Later versions of Visual Studio cannot be used due to the later versions using newer libraries. Later versions will load and compile the VS2015 code fine, but the resulting code will render the sources uncompilable on VS2015 which is what the VCC Development Team is using.
19
22
20
23
VS2015 requires Windows 7 or greater to install. Check the VS2015 "System Requirements" before trying to install on your system.
21
24
22
-
As of the current build, there are no "extras" needed to compile VCC. This may change at any time as we are trying to eventually move the code to cross-compile for cross-platform use, making VCC available for Mac and Linux users and not just the Windows users.
25
+
As of the current build, the only "extras" needed to compile VCC are the Win32 and WinXP compatibility packages to ensure build compatibility with older versions of Windows. This may change at any time as we are trying to eventually move the code to cross-compile for cross-platform use, making VCC available for Mac and Linux users and not just the Windows users.
23
26
24
27
Compiling any VCC sources other than the "Release" source set is not guaranteed. Any branch other than the release may at any time, be in a state of developement in which it is not compilable as we are constantly updating the sources with changes. We will try to maintain the default branch as the "Release" branch ensuring a "running" emulator. For example; the "Original Masters" branch is a copy of Joseph Forgeone's (VCC's original author) original "VS C++ 6" code that when using that platform, will compile into the equivelent of VCC 1.42. It WILL NOT compile under VS2015. These sources are stored here more for historical purposes than anything else.
25
28
26
-
We welcome all bug reports and suggestions. Post any bug reports and/or suggestions on the "Issues" page and we will be promptly notified. We do a "check list" of the issues page every-so-often to see if there's any "quick fixes" we can add while we are working on current changes. The VCC Developement Team is a small one and we work on this when we can as we all have lives and families, so VCC is NOT a priority but a hobby. Even being a hobby, it is also a work of love as we also use this software ourselves, so we try to make it as usable as possible. Sometimes progress is slow and it looks like nothing is going on (and it may not be), but usually, there's plenty going on behind the scenes and we have not committed our current work. Progress is slow, but progress is being made.
27
-
28
29
If you think you have patches or code that could contribute to the VCC project, please contact the developement team and we will see if it fits the current direction of the project, and if so, add it to our code. Be sure to add your name and the date in your comments (and please comment your code well) if you want credit for your work. Also, if your programming skills are up to "snuff" and you feel you would like to join the VCC project, contact us and we will see if you are worthy :-)
29
30
30
31
If you are submitting a "Pull Request", make sure your local repository code is up to date with the current release code. Sometimes VS2015 can not make changes if the code bases are several patches ahead or behind.
31
32
33
+
# NOTES
34
+
32
35
Ok guys, I've found some discrepancies in our build settings and we all need to be on the same page.
33
36
34
37
1. Before doing a pull request make sure the "Project" build properties (right click "Solution 'VCC' (8 projects)"),
35
38
in "Configuration Properties" is set to "Configuration: Release", "Platform: Win32", "Build: Checked", and "Deploy: Unchecked"
36
39
37
-
2.The in each of the 8 projects, right click and select "Properties" then "General" then "Project Defaults", use the pulldown and select "Visual Studio 2015 - Windows XP (v140_xp).
40
+
2.In each of the 8 projects, right click and select "Properties" then "General" then "Project Defaults", use the pulldown and select "Visual Studio 2015 - Windows XP (v140_xp).
38
41
This must be done on each project file.
39
42
These setting are the only way it will build with XP compatibility.
40
43
I will put this in the "readme.md" in the repo so we'll remember it. I just found my solution had been changed by the 2 pulls I've done from the edits we made on the last release (v2.1.0a).
41
44
42
45
If these settings are not found, then your support packages have not been included.
43
46
You must make sure to get the Win32 and WinXP compatibility packages to ensure build compatibility with older versions of Windows.
44
47
48
+
# Contributing to the VCC Project
49
+
50
+
To contribute to our project, you must first create a GitHub account, then clone the VCC project to your account. Create your edits in your local copy of the project and then "Sync" your project back to your GitHub repository. Once your GitHub repository is up to date, you can create a "Pull Request" from within Visual Studio 2015 (or on GitHub). The "Pull Request" will be seen and reviewed by the VCC Project Team and if accepted, will be updated to the main project. Please be sure to refresh your repository with the original project often, as changes are made without notice and could affect you changes as well.
51
+
45
52
We will continue to try to make VCC the best Color Computer Emulator available.
0 commit comments