https://sourceforge.net/p/photproc/wiki/2014-07-22T15:19:16.244000ZRecent changes to wiki2014-07-22T15:19:16.244000Z2014-07-22T15:19:16.244000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.netf021fb4c9f51071f699d3be57a34f4e27273e5f3

<div class="markdown_content"><p>Download the PureFix file here: <a href="https://sourceforge.net/projects/photproc/files">https://sourceforge.net/projects/photproc/files/</a></p></div>

2014-07-15T12:20:46.282000Z2014-07-15T12:20:46.282000Zharhttps://sourceforge.net/u/har-har/https://sourceforge.netdc9843cc44d543dbd06a267d22c661d385792ace

<div class="markdown_content"><p>where can i download this app?</p></div>

2013-08-25T17:02:08.425000Z2013-08-25T17:02:08.425000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.net1d73665af15d0cbb58e0a6d0376e34bb0d7d5957

<div class="markdown_content"><pre>--- v4 +++ v5 @@ -7,9 +7,13 @@ PhotProc can be built to run on Windows. It doesn't have an installer and the user interface is a little strange, but it does work. The project is really in 2 main components: The C++ component that does all the work, and the QML component that provides the user interface. The C++ component creates 4 classes: + * PhotoImageFilter (which is exported to QML) this provides all the user interface features to QML + * ProcessThread (which does background processing for the preview) + * JobQueue: This lets the QML enqueue jobs to save images. Without this you can't save images. + * SaveThread: This is the thread which does all the saving in the background. There is another component: libjpeg. This is taken from a Symbian port of libjpeg, slightly modified to use 32-bits for YUV instead of 24-bits for RGB (to be compatible with Qt). </pre> </div>

2013-08-25T17:01:18.858000Z2013-08-25T17:01:18.858000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.net988c15c51409e19a576e4db45276a8ff0e7ea67c

<div class="markdown_content"><pre>--- v3 +++ v4 @@ -1,11 +1,17 @@ -I haven't yet checked that you can actually download and build the source correctly. Still needs to be done, but I'd be grateful if someone let me know if there are any problems. - Checkout with Mercurial (Hg). I recommend TortoiseHg, it's great. You need QtCreator to build and debug the project. -The project is really in 2 main components: The C++ component that does all the work, and the QML component that provides the user interface. The C++ component creates 2 classes: PhotoImageFilter (which is exported to QML) and ProcessThread (which does background processing). The QML component is Qt's JavaScript based UI system, which you can edit in QtCreator. The hope is that the UI can be much improved entirely within JavaScript. +The user interface is all done in "QML", which means you can change the user interface entirely within QtCreator and not have to do much programming. The "Design" pane lets you edit the UI. You can do bits of programming in JavaScript inside the QML files. It's quite easy! The only oddity is that I have converted PhotProc to work in a multi-platform way. This means that when you edit the UI, you see a generic set of buttons and not the ones that actually appear on the phone or desktop. -There is a 3rd component: libjpeg. This is taken from a Symbian port of libjpeg, slightly modified to use 32-bits for RGBA instead of 24-bits for RGB (to be compatible with Qt). Libjpeg is only used for saving images, not loading. So, most of libjpeg should probably be removed from the project: it isn't needed. I had a problem that I couldn't find a way of saving massive images in Qt. But I still have a problem loading large sections of massive images in Qt (loading the whole image, or a small section works fine now). So, maybe libjpeg should be used for loading images as well? +PhotProc can be built to run on Windows. It doesn't have an installer and the user interface is a little strange, but it does work. -Currently, there is little to no documentation. I'll do some and I'll split it into more logical file structure. +The project is really in 2 main components: The C++ component that does all the work, and the QML component that provides the user interface. The C++ component creates 4 classes: +* PhotoImageFilter (which is exported to QML) this provides all the user interface features to QML +* ProcessThread (which does background processing for the preview) +* JobQueue: This lets the QML enqueue jobs to save images. Without this you can't save images. +* SaveThread: This is the thread which does all the saving in the background. + +There is another component: libjpeg. This is taken from a Symbian port of libjpeg, slightly modified to use 32-bits for YUV instead of 24-bits for RGB (to be compatible with Qt). + +Currently, there is little to no documentation. I'll do some at some point. Most of it is quite logical now though, so you should be able to work it out. Adding new filters is quite easy. </pre> </div>

2013-08-25T16:55:23.621000Z2013-08-25T16:55:23.621000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.net9a70883469ea7c9adc1935b24327335aabef66fb

<div class="markdown_content"><pre>--- v18 +++ v19 @@ -15,6 +15,8 @@ * [Reducing noise in the image with an advanced noise-reduction filter](Reduce noise) PhotProc can process photos up to the full resolution of the PureView 808 (38MP) directly on the phone. It has a background "job queue", which it processes while letting you edit a new photo. It processes preview images as you edit, including letting you zoom in and out. + +Here is a guide by someone using PhotProc: This is currently from a slightly older version of PhotProc, so the interface is a little different, but the advice is still good. What PhotProc can't (currently) do (hey, it's open-source, feel free to add your own features!) </pre> </div>

2013-08-25T16:54:23.502000Z2013-08-25T16:54:23.502000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.net136fb08c90a17f07bb8bc02917b76e582b69e907

<div class="markdown_content"><pre>--- v17 +++ v18 @@ -1,6 +1,4 @@ PhotProc is an open-source photo editing program for Symbian, currently designed especially the PureView 808. The 808 has such a good camera, that it deserves good photo-editing on the phone that takes advantage of the high quality of the images from the camera. - -* PhotProc has had it's user interface changed recently, so some of these buttons and sliders are not in the places they were when this guide was written. The guide will be updated. Also, some features of PhotProc are not described here. TODO! [Using PhotProc](UsingPhotProc) </pre> </div>

2013-08-25T16:51:01.135000Z2013-08-25T16:51:01.135000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.net2b01b554509867fc4662a4582b9ae59010a75a7b

<div class="markdown_content"><pre>--- v7 +++ v8 @@ -2,24 +2,14 @@ Select the "Colours" editing page. - + -You can now select the grey box and move it around. You will see 2 coloured boxes move around and changing colours. PhotProc automatically selects 2 complementary colours. As you move 1 box around, the other is moved to be a complementary colour. +First, select the "Emphasize 1st colour" slider move it up to about half-way (nothing will have any impact until you move this slider up above zero). Now, you can drag the "emphasize 1" box on the right around to select a colour. -There are 2 sliders: "Level" and "Recolour". Level increases or reduces the effect. If you set it to maximum, it will make all other colours completely monochrome. If you set it to minimum, there will be no effect. - -If "recolour" is left at its minimum value, then all areas not the 2 colours you chose will become monochrome. If you set it to maximum, then other colours in the image will be changed so they are closer to the 2 colours you chose. It depends on whether you want to de-emphasize colours that are not the ones you want, or if you actually want to recolour your image into the 2 colours you chose. - -Alternatively, we can use the more advanced colour editing page, marked "Colours". This gives more parameters than "Colourize", so is harder to use. - -Here's an image of a frog where we want to emphasize the orange and some blue: - - - -First, get to the main edit page, then select "Colours". The UI for this is a bit odd at first. To emphasize colours, first select the box marked "Emphasize 1" (it's orange in the above picture). Then, select the slider at the bottom and move it up to about half-way (nothing will have any impact until you move this slider up above zero). Now, you can drag the "emphasize 1" box around to select a colour. + Selecting a colour involves dragging the boxes around. The dragging is working on a colour chart, for which there is a cross-hairs that appears on screen. You can't (currently) select a colour directly from an image. Now, you can select the 2nd colour: press on the "Emphasize 2" box on the screen (it's marked blue in the above screen-shot). Again, you need to move the slider at the bottom, marked "Level" to about half-way. Now you can select the 2nd colour to emphasize, by dragging the emphasize 2 box around to choose the other colour. -There is a "style" slider. If it is all the way left, then no colours are changed, but colours that are different from the 2 you selected will become monochrome. You can change the monochrome colour by selecting a colour for the "Tint" box. If you move the "style" slider to the right, you can alter the colours so the colours in the photo become closer to the 2 you selected. +There is also a "Recolour" slider. If it is all the way left, then no colours are changed, but colours that are different from the 2 you selected will become monochrome. You can change the monochrome colour by selecting a colour for the "Tint" box. If you move the "recolour" slider to the right, you can alter the colours so the colours in the photo become closer to the 2 you selected. </pre> </div>

2013-08-25T16:47:59.089000Z2013-08-25T16:47:59.089000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.net54ee9a080cbba3f9c78236b7a3045190c2383088

<div class="markdown_content"><pre>--- v6 +++ v7 @@ -1,6 +1,8 @@ Say you want to pick out 2 colours to emphasize. It's common to want to pick out 2 complementary colours in an image. -We will start with the easiest editing page: select "Colourize", (not "Colours": that's the complicated one) +Select the "Colours" editing page. + + You can now select the grey box and move it around. You will see 2 coloured boxes move around and changing colours. PhotProc automatically selects 2 complementary colours. As you move 1 box around, the other is moved to be a complementary colour. </pre> </div>

2013-08-25T16:47:18.598000Z2013-08-25T16:47:18.598000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.net758a65e9aa0c0dd059e41028dd8f3c161c77e2b3

<div class="markdown_content"><pre>--- v3 +++ v4 @@ -1,9 +1,15 @@ -To alter the brightness of just dark or light areas of the image, press "Dynamic" on the main page. +To alter the brightness of just dark or light areas of the image, press "Dynamic" on the main edit page. + + + +There are lots of sliders on this page you can use, so you should scroll around to see all of them. + +The "Dynamic Range" slider on this page alters both dark and light areas at the same time and is described in [Dynamic range] You can then use the "Shadows" and "Highlights" sliders. The shadows slider lets you lighten dark areas of the image, without affecting dark details in light areas of the image. The "highlights" slider lets you darken light parts of the image, but is usually less helpful than the "shadows" option. -The "Range" slider on this page alters both dark and light areas at the same time and is described in [Dynamic range] +When lightening dark areas of an image, you can get a lot of "colour noise". This is because you are taking very dark colours and making them much brighter. Go to the "Enhance" page and use the "Reduce dark colours" slider to reduce colours in areas of the image that have been brightened a lot. -When lightening dark areas of an image, you can get a lot of "colour noise". This is because you are taking very dark colours and making them much brighter. Go to the "Enhance" page and use the "Reduce dark colours" slider to reduce colours in areas of the image that have been brightened a lot. +"Dynamic histogram equalization" puts local contrast up to the maximum, really emphasizing details. It creates a lot of noise, but you can see all the details in your image. </pre> </div>

2013-08-25T16:41:54.983000Z2013-08-25T16:41:54.983000ZAndrewhttps://sourceforge.net/u/photproc/https://sourceforge.netece0596dfe1a841968a1c198b053d43603a8320c

<div class="markdown_content"><pre>--- v8 +++ v9 @@ -15,17 +15,32 @@  +You can make the edit page disappear so you can see your photo full-screen by pressing the down arrow in the bottom right-hand corner. To bring up the last edit page you had open, press the up arrow in the bottom right-hand corner. To go back to the main file page, press the menu button in the bottom left hand corner again. + +The main edit page has several options: + +* File: This takes you back to the file open page +* View: Preview/Original: This switches between showing you your original image or the preview +* Reset: This resets all editing parameters to the default. There is no way of undoing this, sorry! +* Levels: This lets you do basic editing for brightness, exposure, saturation etc. +* Colours: This lets you do more advanced colour editing, such as highlighting certain colours or correcting for bad lighting colouring. +* Enhance: This lets you sharpen or de-noise your image. +* Dynamic: This does more complex filters for handling dynamic range and contrast. It can be used to darken shaded areas of images or emphasize details. +* Crop: This lets you crop your image. You get some blue borders you can use to change the crop rectangle +* Info: This shows you information about your photo, including resolution +* Resize: By default, PhotProc outputs photos at 2MP resolution, which is good for social networking and quickly processing an image. You can change this all the way up to the full original resolution (even 41MP!) +* Advanced: You should probably ignore this unless you are a developer and want to write your own filters. + +Pressing one of the above buttons gets you to a full edit page. The editor pages are often larger than the screen, so you should move the page around to see all of the features. The arrow button in the bottom right hand corner makes the current page disappear and reappear. + +You can zoom in, out and around your photos using 2 fingers, or double-tapping on the photo. When you edit a parameters, it will show you a preview, which takes a bit of time to update. It will not actually save or modify the image, it only ever shows you a preview of what the image will look like when it's fully-processed. -You can zoom in and out of the preview with double-tap or pinch. You can pan around by dragging your finger. +You will see some text in the top left showing what the program is currently doing. It might be "Ready", meaning it's waiting for something to happen, or it might be loading a new section of the preview, or re-processing the preview. -You will see some text in the bottom middle showing what the program is currently doing. It might be "Ready", meaning it's waiting for something to happen, or it might be loading a new section of the preview, or re-processing the preview. +When you have got something you like, go back to the main menu and click "Save". This is when the actual full-resolution processing is done, so for very high-resolution images, this can take several minutes. There's a "cancel" button, which cancels the currently-processing job. -When you have got something you like, click "Save". This is when the actual full-resolution processing is done, so for very high-resolution images, this can take 5 minutes. There's a "cancel" button, which cancels the currently-processing job. - -You can also press "back", which takes you back to the main page. You will still see the progress of the image-processing in the top left-hand corner. You can actually have up to 8 image-processing jobs on the go at any one time. There is a "Jobs" button that lets you see the image processing jobs and that also lets you cancel the jobs. +You will still see the progress of the image-processing in the top left-hand corner. You can actually have up to 8 image-processing jobs on the go at any one time. There is a "Jobs" button that appears on the main menu once you have jobs saving that lets you see the image processing jobs and that also lets you cancel the jobs. You can only see the "Exit" button on the main page (keep pressing "back" until you get there) when all photo-processing jobs have finished. - -On the edit page, you can press "Advanced" to get access to the full set of controls (I don't recommend this unless you want to understand how it works internally). You then get a slider down the left and one at the bottom. The slider down the left lets you choose parameters to modify. The slider at the bottom lets you modify the parameters. Press "reset" to go back to the default parameters. If you press "back", the parameters will not be lost. In the top left, it will show the parameter name, and the parameter group (the group gives you a hint as to what the parameter might work with. Sometimes parameters work together as a group). </pre> </div>