Модуль:Filename

Данный модуль генерирует стандартные имена для иконок и иных изображений различных объектов League of Legends и Teamfight Tactics.

Список функций

В угловых скобках указывается переменное значение

Название	Стандартное имя	Пример
ability	<Название умения>.png <Название умения> <Вариация иконки>.png	Fox-Fire.png Fox-Fire old.png
buff	<Название усиления> buff.png <Название усиления> <Вариация иконки>.png	Crest of Insight buff.png Crest of Insight buff old.png
championcircle	<Имя чемпиона> <Образ чемпиона>Circle.png <Имя чемпиона><Образ чемпиона> Circle <Вариант иконки>.png	Lux OriginalCircle.png Lux ElementalistCircle.png Lux OriginalCircle old.png
chroma	<Имя чемпиона> <Образ чемпиона> (<Название цветовой схемы>).png	Ahri Arcana (Ruby).png
item	<Название предмета> item.png <Название предмета> item <Вариант иконки>.png	Rabadon's Deathcap item.png
itemTFT	<Название предмета> TFT item.png	Rabadon's Deathcap TFT item.png
loading	<Имя чемпиона> <Образ чемпиона>Loading.png <Имя чемпиона><Образ чемпиона> Loading <Вариант иконки>.png	Lux OriginalLoading.png Lux ElementalistLoading.png Lux OriginalLoading old.png
monster	<Имя монстра>Square.png <Имя монстра>Square <Вариант иконки>.png	Void HeraldSquare.png
rune	<Название руны> rune.png <Название руны> rune <Вариант иконки>.png	Electrocute rune.png
skin	<Имя чемпиона> <Образ чемпиона>Skin.jpg <Имя чемпиона><Образ чемпиона> Skin <Вариант иконки>.jpg	Lux OriginalSkin.jpg Lux ElementalistSkin.jpg Lux OriginalSkin old.jpg
centered	<Имя чемпиона> <Образ чемпиона>Centered.jpg <Имя чемпиона><Образ чемпиона> Centered <Вариант иконки>.jpg	Lux OriginalCentered.jpg Lux ElementalistCentered.jpg Lux OriginalCentered old.jpg
spell	<Заклинание призывателя> заклинание.png <Заклинание призывателя> заклинание <Вариант иконки>.png	Исцеление заклинание.png
universe	<Название вселенной>.png	Runeterra.png

From Модуль:Filename/doc

---

-- <pre>
local Filename = {}
 
-- Dependencies
local lib          = require('Модуль:Feature')
local UE           = require("Dev:User error")
local LoLChampions = require("Модуль:ChampionData")
local ERROR_CATEGORY = "Filename errors"
 
function Filename.ability(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s %s.png', args['ability'] or args[1], args['variant'] or args[2])
    or
        formatnil('%s.png', args['ability'] or args[1])
    or
        'Placeholder.svg')))
end
 
function Filename.buff(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s buff %s.png', args['engname'] or args['buff'] or args[1], args['variant'] or args[2])
    or
        formatnil('%s buff.png', args['engname'] or args['buff'] or args[1])
    or
        'Placeholder.svg')))
end

-- Возвращает стандартное название круглой иконки чемпиона
-- Принимает на вход имя чемпиона и образа, и/или также английских названий
-- Если переданы русские названия, находит их перевод в соответствующих модулях
function Filename.championcircle(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    
    local champion = args["champion"] or args[1]
    local skin = args["skin"] or args[2] or "Original"
    local variant = args["variant"] or args[3]
    
    local engname = args["engname"]
    local engskin = args["engskin"]
    
    if(engname == nil) then
    	return UE(mw.ustring.format(
			"Для чемпиона %s не найдено английское имя (message from Модуль:Filename)",
			champion), ERROR_CATEGORY)
    end
    
    if(skin == "") then skin = "Original" end
    if(skin ~= "Original") then
    	if(engskin == nil) then
			return UE(mw.ustring.format(
				"Для образа \"%s\" чемпиона \"%s\" не найдено английское имя (message from Модуль:Filename)",
				skin,
				champion), ERROR_CATEGORY)
    	end
    else
    	engskin = skin
    end
	
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s %sCircle %s.png', engname, string.gsub(engskin, " ", ""), variant)
    or
        formatnil('%s %sCircle.png', engname, string.gsub(engskin, " ", ""))
    or
        'ChampionSquare.png')))
end

-- Возвращает стандартное название квадратной иконки чемпиона
-- Принимает на вход имя чемпиона и образа, и/или также английских названий
-- Если переданы русские названия, находит их перевод в соответствующих модулях
function Filename.championsquare(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    
    local champion = args["champion"] or args[1]
    local skin = args["skin"] or args[2] or "Original"
    local variant = args['variant'] or args[3]
    
    local engname = args["engname"]
    local engskin = args["engskin"]
    
    if(engname == nil) then
    	if(LoLChampions.get{champion, "exists"}) then
    		engname = LoLChampions.get{champion, "engname"}
    	else
    		return UE(mw.ustring.format(
    				"Чемпион %s не найден в Модуль:ChampionData/data (message from Модуль:Filename)",
    				champion), ERROR_CATEGORY)
    	end
    end
    
    if(engname == nil) then
    	return UE(
			mw.ustring.format(
				"Чемпион %s не найден в Модуль:ChampionData/data (message from Модуль:Filename)",
				champion),
			ERROR_CATEGORY)
    end
    
    if(skin ~= "Original") then
    	if(engskin == nil) then
			return UE(mw.ustring.format(
				"Образ \"%s\" чемпиона \"%s\" не найден в Модуль:SkinData/data/%s (message from Модуль:Filename)",
				skin,
				champion,
				engname), ERROR_CATEGORY)
    	end
    else
    	engskin = skin
    end
	
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s %sSquare %s.png', engname, string.gsub(engskin, " ", ""), variant)
    or
        formatnil('%s %sSquare.png', engname, string.gsub(engskin, " ", ""))
    or
        'ChampionSquare.png')))
end


function Filename.chroma(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    local champion = args["champion"] or args[1]
    local skin = args["skin"] or args[2] or "Original"
    local chroma = args["chroma"] or args[3]
    
    local engname = args["engname"]
    local engskin = args["engskin"]
    
    if(engname == nil) then
    	return UE(
			mw.ustring.format(
				"Для чемпиона %s не найдено английское имя (message from Модуль:Filename)",
				champion),
			ERROR_CATEGORY)
    end
    
    if(skin ~= "Original") then
    	if(engskin == nil) then
			return UE(mw.ustring.format(
				"Для образа \"%s\" чемпиона \"%s\" не найдено английское имя (message from Модуль:Filename)",
				skin,
				champion), ERROR_CATEGORY)
    	end
    else
    	engskin = skin
    end

    return handleArgs(args, mw.text.trim(encode(
    	formatnil("%s %s (%s).png", engname, string.gsub(engskin, " ", ""), chroma or "Placeholder.svg")
    )))
end
 
function Filename.item(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    local itemName = args["item"] or args[1]
    local imageName = args['engname'] or itemName
	
    if (args['enchantment']) then
        result = handleArgs(args, mw.text.trim(encode(
            formatnil('%s (%s) item %s.png', imageName, args['enchantment'] or args[2], args['variant'] or args[3])
        or
            formatnil('%s (%s) item.png', imageName, args['enchantment'] or args[2])
        or
            'Placeholder.svg')))
    else
        result = handleArgs(args, mw.text.trim(encode(
            formatnil('%s item %s.png', imageName, args['variant'] or args[2])
        or
        	lib.ternary(
        		args["hd"] == "true", 
        		formatnil('%s item HD.png', imageName),
        		formatnil('%s item.png', imageName)
        	)
        or
            'Placeholder.svg')))
    end
    return result
end
 
function Filename.loading(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
	local champion = args["champion"] or args[1]
	
    local parsedName = _specialCaseChampions(champion) -- Проверить альтернативные имена чемпионов
    if(parsedName == champion) then -- Если нет изменений
    	parsedName = LoLChampions.get{parsedName, "engname"}
    end
    
    local skinName = args["skin"] or args[2] or "Original"
    if(skinName ~= "Original") then
    	local result, championSkins = pcall(mw.loadData, "Модуль:SkinData/data/" .. parsedName)
    	if(not(result)) then
    		return UE(mw.ustring.format("Ошибка при загрузке модуля SkinData/data/%s (message from Модуль:Filename)", parsedName))
    	end
	    if(championSkins[champion]["skins"][skinName] ~= nil) then
	    	skinName = championSkins[champion]["skins"][skinName].engname or skinName
	    else
	    	skinName = "Original"
	    end
	end
    
    return handleArgs(args, mw.text.trim(encode(
        formatnil("%s %sLoading %s.jpg", parsedName, string.gsub(skinName, " ", ""), args["variant"] or args[3])
    or
        formatnil("%s %sLoading.jpg", parsedName, string.gsub(skinName, " ", ""))
    or
        "Champion SkinLoading.jpg")))
end
 
function Filename.mastery(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s талант %d.png', args['mastery'] or args[1], tonumber(args['season'] or args[2]))
    or 
        'Placeholder.svg')))
end
 
function Filename.monster(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%sSquare %s.png', args['monster'] or args[1], args['variant'] or args[2])
    or
        formatnil('%sSquare.png', args['monster'] or args[1])
    or
        'Placeholder.svg')))
end
 
function Filename.profileicon(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s profileicon %s.png', args['profileicon'] or args[1], args['variant'] or args[2])
    or
        formatnil('%s profileicon.png', args['profileicon'] or args[1])
    or
        'Placeholder.svg')))
end
 
function Filename.rune(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s rune %s.png', args['rune'] or args[1], args['variant'] or args[2])
    or
        formatnil('%s rune.png', args['rune'] or args[1])
    or
        'Placeholder.svg')))
end
 
function Filename.runeold(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s %s %d.png', args['stat'] or args[1], args['rune'] or args[2], tonumber(args['tier'] or args[3]))
    or
        'Placeholder.svg')))
end
 
function Filename.skin(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
	local champion = args['champion'] or args[1]
	-- Проверить, является ли альтернативным именем (например, Рааст для Каина)
    local parsedName = _specialCaseChampions(champion)
    if(parsedName == champion) then -- Если не изменилось имя, просто искать чемпиона в /data
    	parsedName = LoLChampions.get{parsedName, "engname"}
    end
    
    local skinName = args['skin'] or args[2] or "Original"
    if(skinName ~= "Original") then
    	local result, championSkins = pcall(mw.loadData, "Модуль:SkinData/data/" .. parsedName)
    	if(not(result)) then
    		return UE(mw.ustring.format("Ошибка при загрузке модуля SkinData/data/%s (message from Модуль:Filename)", parsedName))
    	end
	    if(championSkins[champion]["skins"][skinName] ~= nil) then
	    	skinName = championSkins[champion]["skins"][skinName].engname or skinName
	    else
	    	skinName = "Original"
	    end
	end
    
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s %sSkin %s.jpg', parsedName, string.gsub(skinName, ' ', ''), args['variant'] or args[3])
    or
        formatnil('%s %sSkin.jpg', parsedName, string.gsub(skinName, ' ', ''))
    or
        'Champion SkinSkin.jpg')))
end

function Filename.centered(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
	local champion = args['champion'] or args[1]
	-- Проверить, является ли альтернативным именем (например, Рааст для Каина)
    local parsedName = _specialCaseChampions(champion)
    if(parsedName == champion) then -- Если не изменилось имя, просто искать чемпиона в /data
    	parsedName = LoLChampions.get{parsedName, "engname"}
    end
    
    local skinName = args['skin'] or args[2] or "Original"
    if(skinName ~= "Original") then
    	local result, championSkins = pcall(mw.loadData, "Модуль:SkinData/data/" .. parsedName)
    	if(not(result)) then
    		return UE(mw.ustring.format("Ошибка при загрузке модуля SkinData/data/%s (message from Модуль:Filename)", parsedName))
    	end
	    if(championSkins[champion]["skins"][skinName] ~= nil) then
	    	skinName = championSkins[champion]["skins"][skinName].engname or skinName
	    else
	    	skinName = "Original"
	    end
	end
    
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s %sCentered %s.jpg', parsedName, string.gsub(skinName, ' ', ''), args['variant'] or args[3])
    or
        formatnil('%s %sCentered.jpg', parsedName, string.gsub(skinName, ' ', ''))
    or
        'Champion SkinSkin.jpg')))
end
 
function Filename.spell(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s заклинание %s.png', args['spell'] or args[1], args['variant'] or args[2])
    or
        formatnil('%s заклинание.png', args['spell'] or args[1])
    or
        'Placeholder.svg')))
end
 
function Filename.ward(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(formatnil('%s тотем.png', args['ward'] or args[1]) or 'Placeholder.svg')))
end

function Filename.faction(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(formatnil('%s Герб иконка.png', args['faction'] or args[1]) or 'Placeholder.svg')))
end

function Filename.universe(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    local skinlines = mw.loadData('Модуль:UniverseData/skinlines')
    local universes = mw.loadData('Модуль:UniverseData/au')
    local sLine = args['universe'] or args[1]
    local icon = 'Universe Default icon.png'
    
    local universeIcons = { -- Содержит исключения из правил поиска иконок
        ['Горизонт событий'] = "Galaxies 2020 profileicon.png",
        ['Звездные защитники'] = "Mark of the Star Guardian profileicon.png",
        ['Хаос и Порядок'] = "Night & Dawn Event profileicon.png"
    }
    
    if skinlines[sLine] then
        icon = skinlines[sLine].icon or 'Universe Default icon.png'
        return handleArgs(args, mw.text.trim(encode(formatnil(icon))))
    elseif universes[sLine] then -- Если не линейка образов, но название вселенной
        if universeIcons[sLine] then -- Проверка исключения
            icon = universeIcons[sLine]
        else -- Взять иконку у первой линейки из этой вселенной
            icon = skinlines[universes[sLine][1]]['icon'] or 'Universe Default icon.png'
        end
        
        return handleArgs(args, mw.text.trim(encode(formatnil(icon))))
    end
    
    return handleArgs(args, mw.text.trim(encode(formatnil(icon))))
end

function Filename.itemTFT(frame)
    local args; if frame.args == nil then args = lib.arguments(frame) else args = lib.arguments(frame.args) end
    return handleArgs(args, mw.text.trim(encode(
        formatnil('%s TFT item.png', args['engname'] or args["item"] or args[1])
    or
        'Placeholder.svg')))
end
 
-- Helper functions
function Filename.encode(frame)
    return mw.text.trim(encode(frame.args[1]))
end
 
function encode(text)
    if text == nil then return nil end
    text = mw.ustring.gsub(text, ':', '-')
    text = mw.ustring.gsub(text, '/', '')
    return text
end
 
function handleArgs(args, filename)
    local result = filename
    if args['prefix'] then filename = args['prefix'] .. filename end
    if args['suffix'] then filename = filename .. args['suffix'] end
    if args['parse'] then filename = mw.getCurrentFrame():preprocess(filename) end
    return result
end
 
function formatnil(text, ...)
    if select("#", ...) == 0 then return text end
    for i=1, select("#", ...) do
        if select(i, ...) == nil then return nil end
    end
    return mw.ustring.format(text, ...)
end

function _specialCaseChampions(championName)
	local specialCases = mw.loadData("Модуль:ChampionData/Validator")
	local championEngnames = mw.loadData("Модуль:ChampionData/engnames")
	if(specialCases[championName]) then
		local correctName = specialCases[championName]
		if(championEngnames[correctName]) then
			return championEngnames[correctName]
		end
	end
	return championName
end
 
return Filename
-- </pre>
-- [[Category:Lua]]