Skip to content

Commit fef9817

Browse files
committed
include link in readme
1 parent 62187d3 commit fef9817

File tree

3 files changed

+62
-48
lines changed

3 files changed

+62
-48
lines changed

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,7 @@ high-level support for formatted files (in contrast with julia's
1111
low-level `read` and `write`). To avoid name conflicts, packages that
1212
provide support for standard file formats through functions named
1313
`load` and `save` are encouraged to extend the definitions here.
14+
[Supported Files](docs/registry.md)
1415

1516
## Installation
1617

docs/make_docs.jl

Lines changed: 18 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,23 @@
11
using FileIO, Compat
22
import FileIO: LOAD, SAVE, OSX, OS
33
const fs = open(Pkg.dir("FileIO", "docs", "registry.md"), "w")
4+
5+
function pkg_url(pkgname)
6+
result = readchomp(Pkg.dir("METADATA", string(pkgname), "url"))
7+
g = "git://"
8+
if startswith(result, g)
9+
return string("http://", result[length(g):end])
10+
end
11+
result
12+
end
13+
library2string(x) = "[$(x)]($(pkg_url(x)))"
14+
415
extension2string(x) = join(map(string, x), ", ")
516
extension2string(x::AbstractString) = x
6-
os2string(x::Vector) = isempty(x) ? "ALL" : join(map(os2string, x), ", ")
7-
os2string{O <: OS}(os::Type{O}) = string(O.name.name)
17+
18+
os2string(x::Vector) = isempty(x) ? "**all** platforms " : join(map(os2string, x), ", ")
19+
os2string{O <: OS}(os::Type{O}) = "**$(O.name.name)**"
20+
821
magic2string(x::Function) = "has detection function"
922
magic2string(x::Tuple) = isempty(x) ? "only extension": string(x)
1023
magic2string(x) = string(x)
@@ -16,11 +29,11 @@ function loadsave2string(load_save_libraries)
1629

1730
os, loadsave = FileIO.split_predicates(predicates)
1831
if isempty(loadsave)
19-
print(io, "loads and saves on all platforms with ", library)
32+
print(io, "loads and saves on **all** platforms with ", library2string(library))
2033
elseif (LOAD in loadsave)
21-
print(io, "loads with ", library, " on: ", os2string(os), " ")
34+
print(io, "loads with ", library2string(library), " on: ", os2string(os), " ")
2235
elseif (SAVE in loadsave)
23-
print(io, "loads with ", library, " on: ", os2string(os), " ")
36+
print(io, "loads with ", library2string(library), " on: ", os2string(os), " ")
2437
end
2538
end
2639
takebuf_string(io)

docs/registry.md

Lines changed: 43 additions & 43 deletions
Original file line numberDiff line numberDiff line change
@@ -1,47 +1,47 @@
11
| Format Name | extensions | IO library | detection or magic number |
22
| ----------- | ---------- | ---------- | ---------- |
3-
| JLD | .jld | loads and saves on all platforms with JLD | Julia data file (HDF5) |
4-
| PBMBinary | .pbm | loads and saves on all platforms with ImageMagick | UInt8[0x50,0x34] |
5-
| PGMBinary | .pgm | loads and saves on all platforms with Netpbm | UInt8[0x50,0x35] |
6-
| PPMBinary | .ppm | loads and saves on all platforms with Netpbm | UInt8[0x50,0x36] |
7-
| PBMText | .pbm | loads with ImageMagick on: ALL | UInt8[0x50,0x31] |
8-
| PGMText | .pgm | loads with ImageMagick on: ALL | UInt8[0x50,0x32] |
9-
| PPMText | .ppm | loads with ImageMagick on: ALL | UInt8[0x50,0x33] |
10-
| NRRD | .nrrd, .nhdr | loads and saves on all platforms with NRRD | NRRD |
11-
| AndorSIF | .sif | loads with AndorSIF on: ALL | Andor Technology Multi-Channel File |
12-
| CRW | .crw | loads and saves on all platforms with ImageMagick | UInt8[0x49,0x49,0x1a,0x00,0x00,0x00,0x48,0x45] |
13-
| CUR | .cur | loads and saves on all platforms with ImageMagick | UInt8[0x00,0x00,0x02,0x00] |
14-
| DCX | .dcx | loads and saves on all platforms with ImageMagick | UInt8[0xb1,0x68,0xde,0x3a] |
15-
| DOT | .dot | loads and saves on all platforms with ImageMagick | UInt8[0xd0,0xcf,0x11,0xe0,0xa1,0xb1,0x1a,0xe1] |
16-
| EPS | .eps | loads and saves on all platforms with ImageMagick | UInt8[0x25,0x21,0x50,0x53,0x2d,0x41,0x64,0x6f] |
17-
| HDR | .hdr | loads and saves on all platforms with ImageMagick | UInt8[0x23,0x3f,0x52,0x41,0x44,0x49,0x41,0x4e] |
18-
| ICO | .ico | loads and saves on all platforms with ImageMagick | UInt8[0x00,0x00,0x01,0x00] |
19-
| INFO | .info | loads and saves on all platforms with ImageMagick | UInt8[0x7a,0x62,0x65,0x78] |
20-
| JP2 | .jp2 | loads and saves on all platforms with ImageMagick | UInt8[0x00,0x00,0x00,0x0c,0x6a,0x50,0x20,0x20] |
21-
| PCX | .pcx | loads and saves on all platforms with ImageMagick | UInt8[0x0a,0x05,0x01,0x01] |
22-
| PDB | .pdb | loads and saves on all platforms with ImageMagick | UInt8[0x73,0x7a,0x65,0x7a] |
23-
| PDF | .pdf | loads and saves on all platforms with ImageMagick | UInt8[0x25,0x50,0x44,0x46] |
24-
| PGM | .pgm | loads and saves on all platforms with ImageMagick | UInt8[0x50,0x35,0x0a] |
25-
| PSD | .psd | loads and saves on all platforms with ImageMagick | UInt8[0x38,0x42,0x50,0x53] |
26-
| RGB | .rgb | loads and saves on all platforms with ImageMagick | UInt8[0x01,0xda,0x01,0x01,0x00,0x03] |
27-
| WMF | .wmf | loads and saves on all platforms with ImageMagick | UInt8[0xd7,0xcd,0xc6,0x9a] |
28-
| WPG | .wpg | loads and saves on all platforms with ImageMagick | UInt8[0xff,0x57,0x50,0x43] |
29-
| Imagine | .imagine | loads and saves on all platforms with ImagineFormat | IMAGINE |
30-
| TGA | .tga | loads with QuartzImageIO on: OSX loads and saves on all platforms with ImageMagick | only extension |
31-
| GIF | .gif | loads with QuartzImageIO on: OSX loads and saves on all platforms with ImageMagick | UInt8[0x47,0x49,0x46,0x38] |
32-
| PNG | .png | loads with QuartzImageIO on: OSX loads and saves on all platforms with ImageMagick | UInt8[0x89,0x50,0x4e,0x47,0x0d,0x0a,0x1a,0x0a] |
33-
| TIFF | .tiff, .tif | loads with QuartzImageIO on: OSX loads and saves on all platforms with ImageMagick | (UInt8[0x4d,0x4d,0x00,0x2a],UInt8[0x4d,0x4d,0x00,0x2b],UInt8[0x49,0x49,0x2a,0x00]) |
34-
| JPEG | .jpeg, .jpg, .JPG | loads with QuartzImageIO on: OSX loads and saves on all platforms with ImageMagick | UInt8[0xff,0xd8,0xff] |
35-
| BMP | .bmp | loads with QuartzImageIO on: OSX loads and saves on all platforms with ImageMagick | UInt8[0x42,0x4d] |
36-
| GLSLShader | .frag, .vert, .geom, .comp | loads and saves on all platforms with GLAbstraction | only extension |
37-
| OBJ | .obj | loads and saves on all platforms with MeshIO | only extension |
38-
| PLY_ASCII | .ply | loads and saves on all platforms with MeshIO | ply
3+
| JLD | .jld | loads and saves on **all** platforms with [JLD](http:///github.com/JuliaLang/JLD.jl.git) | Julia data file (HDF5) |
4+
| PBMBinary | .pbm | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x50,0x34] |
5+
| PGMBinary | .pgm | loads and saves on **all** platforms with [Netpbm](http:///github.com/JuliaIO/Netpbm.jl.git) | UInt8[0x50,0x35] |
6+
| PPMBinary | .ppm | loads and saves on **all** platforms with [Netpbm](http:///github.com/JuliaIO/Netpbm.jl.git) | UInt8[0x50,0x36] |
7+
| PBMText | .pbm | loads with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) on: **all** platforms | UInt8[0x50,0x31] |
8+
| PGMText | .pgm | loads with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) on: **all** platforms | UInt8[0x50,0x32] |
9+
| PPMText | .ppm | loads with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) on: **all** platforms | UInt8[0x50,0x33] |
10+
| NRRD | .nrrd, .nhdr | loads and saves on **all** platforms with [NRRD](http:///github.com/JuliaIO/NRRD.jl.git) | NRRD |
11+
| AndorSIF | .sif | loads with [AndorSIF](http:///github.com/JuliaIO/AndorSIF.jl.git) on: **all** platforms | Andor Technology Multi-Channel File |
12+
| CRW | .crw | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x49,0x49,0x1a,0x00,0x00,0x00,0x48,0x45] |
13+
| CUR | .cur | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x00,0x00,0x02,0x00] |
14+
| DCX | .dcx | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0xb1,0x68,0xde,0x3a] |
15+
| DOT | .dot | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0xd0,0xcf,0x11,0xe0,0xa1,0xb1,0x1a,0xe1] |
16+
| EPS | .eps | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x25,0x21,0x50,0x53,0x2d,0x41,0x64,0x6f] |
17+
| HDR | .hdr | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x23,0x3f,0x52,0x41,0x44,0x49,0x41,0x4e] |
18+
| ICO | .ico | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x00,0x00,0x01,0x00] |
19+
| INFO | .info | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x7a,0x62,0x65,0x78] |
20+
| JP2 | .jp2 | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x00,0x00,0x00,0x0c,0x6a,0x50,0x20,0x20] |
21+
| PCX | .pcx | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x0a,0x05,0x01,0x01] |
22+
| PDB | .pdb | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x73,0x7a,0x65,0x7a] |
23+
| PDF | .pdf | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x25,0x50,0x44,0x46] |
24+
| PGM | .pgm | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x50,0x35,0x0a] |
25+
| PSD | .psd | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x38,0x42,0x50,0x53] |
26+
| RGB | .rgb | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x01,0xda,0x01,0x01,0x00,0x03] |
27+
| WMF | .wmf | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0xd7,0xcd,0xc6,0x9a] |
28+
| WPG | .wpg | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0xff,0x57,0x50,0x43] |
29+
| Imagine | .imagine | loads and saves on **all** platforms with [ImagineFormat](http:///github.com/timholy/ImagineFormat.jl.git) | IMAGINE |
30+
| TGA | .tga | loads with [QuartzImageIO](http:///github.com/JuliaIO/QuartzImageIO.jl.git) on: **OSX** loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | only extension |
31+
| GIF | .gif | loads with [QuartzImageIO](http:///github.com/JuliaIO/QuartzImageIO.jl.git) on: **OSX** loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x47,0x49,0x46,0x38] |
32+
| PNG | .png | loads with [QuartzImageIO](http:///github.com/JuliaIO/QuartzImageIO.jl.git) on: **OSX** loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x89,0x50,0x4e,0x47,0x0d,0x0a,0x1a,0x0a] |
33+
| TIFF | .tiff, .tif | loads with [QuartzImageIO](http:///github.com/JuliaIO/QuartzImageIO.jl.git) on: **OSX** loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | (UInt8[0x4d,0x4d,0x00,0x2a],UInt8[0x4d,0x4d,0x00,0x2b],UInt8[0x49,0x49,0x2a,0x00]) |
34+
| JPEG | .jpeg, .jpg, .JPG | loads with [QuartzImageIO](http:///github.com/JuliaIO/QuartzImageIO.jl.git) on: **OSX** loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0xff,0xd8,0xff] |
35+
| BMP | .bmp | loads with [QuartzImageIO](http:///github.com/JuliaIO/QuartzImageIO.jl.git) on: **OSX** loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | UInt8[0x42,0x4d] |
36+
| GLSLShader | .frag, .vert, .geom, .comp | loads and saves on **all** platforms with [GLAbstraction](http:///github.com/JuliaGL/GLAbstraction.jl.git) | only extension |
37+
| OBJ | .obj | loads and saves on **all** platforms with [MeshIO](http:///github.com/JuliaIO/MeshIO.jl.git) | only extension |
38+
| PLY_ASCII | .ply | loads and saves on **all** platforms with [MeshIO](http:///github.com/JuliaIO/MeshIO.jl.git) | ply
3939
format ascii 1.0 |
40-
| PLY_BINARY | .ply | loads and saves on all platforms with MeshIO | ply
40+
| PLY_BINARY | .ply | loads and saves on **all** platforms with [MeshIO](http:///github.com/JuliaIO/MeshIO.jl.git) | ply
4141
format binary_little_endian 1.0 |
42-
| 2DM | .2dm | loads and saves on all platforms with MeshIO | MESH2D |
43-
| OFF | .off | loads and saves on all platforms with MeshIO | OFF |
44-
| AVI | .avi | loads and saves on all platforms with ImageMagick | has detection function |
45-
| HDF5 | .h5, .hdf5 | loads and saves on all platforms with HDF5 | has detection function |
46-
| STL_ASCII | .stl, .STL | loads and saves on all platforms with MeshIO | has detection function |
47-
| STL_BINARY | .stl, .STL | loads and saves on all platforms with MeshIO | has detection function |
42+
| 2DM | .2dm | loads and saves on **all** platforms with [MeshIO](http:///github.com/JuliaIO/MeshIO.jl.git) | MESH2D |
43+
| OFF | .off | loads and saves on **all** platforms with [MeshIO](http:///github.com/JuliaIO/MeshIO.jl.git) | OFF |
44+
| AVI | .avi | loads and saves on **all** platforms with [ImageMagick](http:///github.com/JuliaIO/ImageMagick.jl.git) | has detection function |
45+
| HDF5 | .h5, .hdf5 | loads and saves on **all** platforms with [HDF5](http:///github.com/JuliaLang/HDF5.jl.git) | has detection function |
46+
| STL_ASCII | .stl, .STL | loads and saves on **all** platforms with [MeshIO](http:///github.com/JuliaIO/MeshIO.jl.git) | has detection function |
47+
| STL_BINARY | .stl, .STL | loads and saves on **all** platforms with [MeshIO](http:///github.com/JuliaIO/MeshIO.jl.git) | has detection function |

0 commit comments

Comments
 (0)